home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / flstd200.zip / FASTLST.DOC < prev    next >
Text File  |  1997-06-19  |  122KB  |  3,269 lines

  1.         **************************************************************
  2.         *                                                            *
  3.         *                                                            *
  4.         *   *******   **     ****   ******  ****     ****   ******   *
  5.         *    **   *  ****   **  **  * ** *   **     **  **  * ** *   *
  6.         *    ** *   **  **  **        **     **     **        **     *
  7.         *    ****   **  **   ****     **     **      ****     **     *
  8.         *    ** *   ******      **    **     **   *     **    **     *
  9.         *    **     **  **  **  **    **     **  ** **  **    **     *
  10.         *   ****    **  **   ****    ****   *******  ****    ****    *
  11.         *                                                            *
  12.         *                                                            *
  13.         *                         Version 2.00                       *
  14.         *                                                            *
  15.         *             The ultimate V7+ nodelist processor            *
  16.         *                                                            *
  17.         *                                                            *
  18.         **************************************************************
  19.         *                                                            *
  20.         *        (C) Copyright 1992-1997  by  Alberto Pasquale       *
  21.         *                                                            *
  22.         *            A L L   R I G H T S   R E S E R V E D           *
  23.         *                                                            *
  24.         **************************************************************
  25.         
  26.         
  27.  
  28.                 FastLst 2.00 User's Manual, by Alberto Pasquale
  29.         
  30.         
  31.                                   INTRODUCTION
  32.         
  33.         
  34.         -> For licensing information, please see License.Doc.
  35.         
  36.         Thanks for evaluating FastLst: the ultimate "Version 7+"
  37.         nodelist processor.
  38.         
  39.         Version 7 is a common format for binary nodelists to be used by
  40.         mailers, message editors and all the programs that need fast
  41.         access to a compiled nodelist.
  42.         
  43.         Version 7+ is fully compatible with V7 and adds lots of new
  44.         powerful features for V7+ aware applications.
  45.         
  46.                                  Main Features
  47.         
  48.         
  49.         - Compiles to Version 7+ format nodelist.
  50.         
  51.         - Support for Version 7.
  52.         
  53.         - Support for old "Fidouser.Lst" sysop list.
  54.         
  55.         - Multiple output nodelist (NODEX.*) compilation from one config
  56.           file.
  57.         
  58.         - The complete maintenance of archived lists and diffs is
  59.           achieved through internal flexible configuration, with no need
  60.           for clumsy batch files.
  61.         
  62.         - Uses "Squish Style" Compress.Cfg.
  63.         
  64.         - Can be invoked from a batch file at predefined events: the
  65.           compilation will take place only if some new list/diff is
  66.           found.
  67.         
  68.         - Multitasking friendly
  69.         
  70.         - The OS/2 version allows for priority setting in the
  71.           configuration file.
  72.         
  73.         - Compilation reports can be posted to Fido or Squish format
  74.           message areas.
  75.         
  76.         - Full 4D (point) support, both via the "Point,..." and
  77.           "Boss,..." keywords.
  78.         
  79.         - Internal support for "German type" pointlists.
  80.         
  81.         - Easy addition of nodes via the "Node,<address>,..." keyword
  82.           in a private list.
  83.         
  84.         - Easy specification of phone strings to be taken "verbatim"
  85.           for internet addresses and script names.
  86.         
  87.         - In the case of SysOps of multiple nodes, keeps all the
  88.           name/address entries in the sysop index.
  89.         
  90.         - User Cost (Msg Fee) can be set different from Call Cost.
  91.         
  92.                                     CREDITS
  93.         
  94.         This program uses the Squish "MsgAPI" code, Copyright 1991-1994
  95.         by Lanius Corporation. "Squish" and "Maximus" are trademarks of
  96.         Lanius Corporation.
  97.         
  98.         "BinkleyTerm" is a trademark of Bit Bucket Software Co.
  99.         
  100.         "4OS2" is a trademark of JP Software Inc.
  101.         
  102.         The archivers referred-to throughout this documentation are
  103.         Copyright and/or trademarks of the respective owners.
  104.         
  105.         "VMODEM" and "SIO" are Copyright by Raymond L. Gwinn.
  106.         
  107.         "U.S. Robotics" and "I-modem" are registered trademarks of U.S.
  108.         Robotics Access Corporation.
  109.  
  110.         
  111.                                OVERALL OPERATION
  112.         
  113.         
  114.         FastLst has been designed to be invoked regularly from one of
  115.         your main batch files, after mail has been received or at
  116.         pre-arranged times at your pleasure: if any new (compressed or
  117.         not) nodelist/nodediff is detected, Fastlst processes them as
  118.         required (exiting with Errorlevel 0), otherwise it immediately
  119.         exits (errorlevel 100) with no further delay.
  120.         
  121.         When FastLst detects a changed config or password file, it
  122.         compiles all the affected nodelists even if they are not new.
  123.         
  124.         If you want FastLst to compile all of your nodelists even if no
  125.         new ones are present, you need to use the -f or -i command line
  126.         switch.
  127.         
  128.         For each "output block" in the config file:
  129.         
  130.         - New compressed lists or diffs are detected, unarchived and
  131.           optionally rearchived in supplementary formats.
  132.         
  133.         - New diffs are detected and applied: the resulting new nodelist
  134.           is archived. Before applying a diff, the day number and CRC of
  135.           the old nodelist are compared against the ones requested by
  136.           the diff; after application, the CRC of the new nodelist is
  137.           checked.
  138.         
  139.         - New lists are detected and the pertinent output nodelists are
  140.           rebuilt. If no new list is found for a specific "output
  141.           block", that output nodelist is not compiled, unless the -f or
  142.           -i command line switch is specified.
  143.         
  144.         OS commands can be issued before or after each operation: for
  145.         example you can hatch the just created archive file.
  146.         
  147.         
  148.         ATTENTION:
  149.         
  150.         - Every time a config file is changed, FastLst rebuilds all
  151.           the output nodelists, as if the -f command line switch were
  152.           specified.
  153.         
  154.         - Every time a PasswordFile is changed, FastLst rebuilds the
  155.           nodelists that use it.
  156.         
  157.         - The date of the archive files handled by FastLst is set to
  158.           the same value of the contained file (see ArcDate).
  159.  
  160.         
  161.                              INPUT NODELIST FORMAT
  162.         
  163.         
  164.         The source nodelists and nodediffs must be in standard "St.
  165.         Louis" format, as described in FTS-0005. Anyway, FastLst allows
  166.         some extensions in order to support 4D points, "German style"
  167.         pointlists, easy single node specifications and "verbatim" phone
  168.         strings.
  169.         
  170.         
  171.         
  172.         
  173.                        4D Point Support: POINT and BOSS keywords
  174.         
  175.         
  176.         First method:
  177.         
  178.         Points are entered in the nodelist directly following their
  179.         bossnode.  Each one starts with the "Point,<point>" keyword.
  180.         
  181.         Example:
  182.         
  183.         ...
  184.         ...
  185.         ,504,Videl,Modena_I,Roberto_Zanasi,39-59-450600,9600,CM,XA,V34
  186.         Point,1,Pasquale,Modena_I,Alberto_Pasquale,-!Unpublished-,9600,
  187.         Point,2,SysOp,Modena_I,Roberto_Zanasi,-!Unpublished-,9600,
  188.         Point,3,Carta,Modena,Francesco_Carta,-!Unpublished-,9600,
  189.         ...
  190.         ...
  191.         
  192.         
  193.         Second method:
  194.         
  195.         Points are entered in the nodelist following the
  196.         "Boss,<address>" keyword.
  197.         
  198.         Example:
  199.         
  200.         ...
  201.         ...
  202.         Boss,2:332/504
  203.         ,1,Pasquale,Modena_I,Alberto_Pasquale,-!Unpublished-,9600,
  204.         ,2,SysOp,Modena_I,Roberto_Zanasi,-!Unpublished-,9600,
  205.         ,3,Carta,Modena,Francesco_Carta,-!Unpublished-,9600,
  206.         ...
  207.         ...
  208.  
  209.         
  210.         
  211.                                German Point List
  212.         
  213.         
  214.         This is a "normal" 3D nodelist that lists each Boss as a
  215.         "fakenet" HOST, with the real address as the system name,
  216.         followed by its points listed as nodes.
  217.         
  218.         Example:
  219.         
  220.         The following nodelist segment lists points 2:2400/1.1 .2 .3:
  221.         
  222.         Host,20000,2400/1,City,Sysop_Name,49-951-999999,9600,CM,V34
  223.         ,1,System_Name_1,City_1,Sysop_Name_1,49-951-999999,9600,
  224.         ,2,System_Name_2,City_2,Sysop_Name_2,49-951-999999,9600,
  225.         ,3,System_Name_3,City_3,Sysop_Name_3,49-951-999999,9600,
  226.  
  227.         
  228.         
  229.                                 The NODE Keyword
  230.         
  231.         
  232.         Another extension over FTS-0005 is provided to allow easy
  233.         addition of nodes in small private lists.
  234.         
  235.         When you need to add a node to your nodelist to call it or to
  236.         enforce a session password with it, you can use the
  237.         "Node,<address>[ <region>[ <hub>]],..." keyword to avoid the
  238.         necessity of adding the entries for its coordinators.
  239.         
  240.         You should specify a full 4D address (point optional).
  241.         
  242.         Any subsequent entry will take the current address as a starting
  243.         point.
  244.         
  245.         E.g.: You want to add 9:888/777.3 of Region 88, Hub 700.
  246.         
  247.         Please note that there is no need to specify Region and Hub
  248.         information when using the Node and Boss keywords, since:
  249.         
  250.         - if the point's Boss is included via some other nodelist, the
  251.           Region and Hub information will be taken from its entry;
  252.         
  253.         - if the point's Boss is not present in the compiled lists, this
  254.           point will be removed from the indices (in this case you may
  255.           want to use two entries for including both the Boss and the
  256.           point);
  257.         
  258.         
  259.         With "Node,...":
  260.         ...
  261.         ...
  262.         Node,9:888/777.3,System,City,SysOp,1-234-555-6666,9600,CM
  263.         ...
  264.         ...
  265.         
  266.         With "Boss,...":
  267.         ...
  268.         ...
  269.         Boss,9:888/777
  270.         ,3,System,City,SysOp,1-234-555-6666,9600,CM
  271.         ...
  272.         ...
  273.         
  274.         With the traditional method:
  275.         ...
  276.         ...
  277.         Zone,9,...
  278.         Region,88,...
  279.         Host,888,...
  280.         Hub,700,...
  281.         ,777,...
  282.         Point,3,System,City,SysOp,1-234-555-6666,9600,CM
  283.         ...
  284.         ...
  285.         
  286.         
  287.         Now let's add 8:101/611 and 8:101/612 in region 10, hub 600:
  288.         
  289.         With "Node,...":
  290.         ...
  291.         ...
  292.         Node,8:101/611 10 600,System,City,SysOp,1-234-555-6666,9600,CM
  293.         ,612,System,City,SysOp,1-234-555-6667,9600,CM
  294.         ...
  295.         ...
  296.         
  297.         With the traditional method:
  298.         ...
  299.         ...
  300.         Zone,8,...
  301.         Region,10,...
  302.         Host,101,...
  303.         Hub,600,...
  304.         ,611,System,City,SysOp,1-234-555-6666,9600,CM
  305.         ,612,System,City,SysOp,1-234-555-6666,9600,CM
  306.         ...
  307.         ...
  308.  
  309.         
  310.         
  311.                                 Verbatim Phones
  312.         
  313.         When a phone entry contains non-numeric characters, it is taken
  314.         verbatim (i.e. no dial translation is applied to adjust the area
  315.         code and long distance or international prefixes).
  316.         
  317.         Call defaults are defined by the CostVerbatimPhone statement.
  318.         
  319.         Note: you might need to change the dots '.' in internet
  320.         addresses to asterisks '*', in order to avoid that the mailer
  321.         (e.g. Binkley) translates them: see TypeDef.
  322.         
  323.         Examples:
  324.         
  325.         Internet address:
  326.         
  327.         ,6,System,City,SysOp,Fantasy.Com,9600,CM,VM
  328.         
  329.         IP address:
  330.         
  331.         ,6,System,City,SysOp,123.456.789.012,9600,CM,VM
  332.         
  333.         Script name:
  334.         
  335.         ,6,System,City,SysOp,"Fantasy.Scr",9600,CM,V34
  336.         
  337.         See also the Phone statement.
  338.         
  339.         
  340.         
  341.                                MISCELLANEOUS INFO
  342.         
  343.         
  344.                                 Multiple Sysops
  345.         
  346.         
  347.         In the case of SysOps of more than one system, all the
  348.         name/address couples of compiled entries are output to the SysOp
  349.         index.
  350.         
  351.         
  352.                                Redirected Systems
  353.         
  354.         
  355.         Systems that have no valid phone number (Unpublished, on Hold),
  356.         are redirected, provided you do not exclude redirection using
  357.         the "NoRedir" config keyword.
  358.         
  359.         A redirected system is given the phone number, baud rate, modem
  360.         type, cost and flags of the preceding coordinator, the Board
  361.         name is prepended with '-R-'.
  362.         
  363.         If you have a session password with the system to be redirected
  364.         or with the system it should be redirected to, no redirection is
  365.         done in order to prevent password-mismatch errors in the case
  366.         the Unpublished/Hold system calls you.
  367.         
  368.         Points are never redirected.
  369.         
  370.         The systems that have no valid phone number and cannot be
  371.         redirected take an EMPTY phone number string, so that your
  372.         mailer does not send unexpected strings to your modem attempting
  373.         to call these systems, should something appear in your outbound
  374.         addressed to them.
  375.         
  376.         Pay attention: if you want to directly call these
  377.         null_phone-systems or their coordinators, you have to give them
  378.         a phone number using the "Phone" statement in the configuration
  379.         file.
  380.         
  381.  
  382.         
  383.         
  384.                                   INSTALLATION
  385.         
  386.         
  387.         1) There are 3 versions of FastLst:
  388.         
  389.            OS/2, W32, DOS 32 (with DOS4GW DOS Extender), distributed in
  390.            separate archives (see Readme.1st).
  391.         
  392.            Choose the one that fits you better.
  393.         
  394.         2) Write your FastLst.Cfg.
  395.            You can find useful examples in the Fast_*.Cfg files and
  396.            detailed information in the "CFG REFERENCE" section of this
  397.            documentation.
  398.         
  399.         
  400.         3) Edit your batch file in order to call FastLst whenever you
  401.            would like to test for the presence of new list/diff files
  402.            and process them. If you do not pass a different pathname as
  403.            a command line parameter, FastLst.Cfg must reside in the
  404.            current directory.
  405.         
  406.         
  407.         4) (OS/2): Make sure you have the MSGAPI32.DLL in a directory
  408.              contained in your LIBPATH. MSGAPI32.DLL can be found in the
  409.              Squish 1.11 archive (SQSHP111.LZH).
  410.         
  411.         
  412.            (W32): Make sure you have the MSGAPINT.DLL in a directory
  413.              contained in your PATH. MSGAPINT.DLL can be found in the
  414.              Max 3.01 for Windows archive (MAX301N.ZIP).
  415.         
  416.         
  417.            (DOS32): Make sure you have the DOS4GW.EXE Dos extender (from
  418.              Tenberry Software Inc.) in your path.
  419.         
  420.              The DOS4GW extender requires an XMS or DPMI memory driver
  421.              installed in your config.sys: e.g. HIMEM.SYS, QEMM (by
  422.              QuarterDeck Office Systems Inc.).
  423.         
  424.         
  425.         5) FastLst requires a lot of memory to compile long nodelists.
  426.         
  427.            A set of input nodelists totalling 60,000 nodes requires
  428.            approximately 12MB for V7+ "in memory" compilation, 7MB when
  429.            using "on disk" DTP linking and 4.5MB for simple V7.
  430.         
  431.            You have to decide whether to use the "LinkOnDisk"
  432.            statement in the configuration file. If you have enough
  433.            physical memory available you should use the default "in
  434.            memory" mode. On the other hand, if the execution of FastLst
  435.            is excessively slow, you probably are low on memory and you
  436.            could benefit by the use of "on disk" DTP linking.
  437.         
  438.            (DOS): Even if "in memory" DTP linking is
  439.              configured, FastLst automatically switches to "on disk"
  440.              mode if it cannot allocate the needed memory.
  441.         
  442.              If you experience "out of memory" errors, then you have to
  443.              enable the DOS4GW virtual memory mode, using the DOS4GVM
  444.              environment variable (e.g. for 16MB virtual allocation
  445.              size: SET DOS4GVM=VirtualSize#16384).
  446.         
  447.              This works under real Dos only: if you are using OS/2 dos
  448.              sessions, use a higher DPMI_MEMORY_LIMIT in the Dos
  449.              settings.
  450.         
  451.              Please note that FastLst tells you (on screen, in the
  452.              logs, in the report message) how much memory remains during
  453.              compilation, so that you can realize when you are running
  454.              in marginal conditions and consequently adjust your
  455.              configuration before you run out of memory.
  456.         
  457.         
  458.         
  459.                              COMMAND LINE SWITCHES
  460.         
  461.         
  462.         -c<cfg>
  463.                 Use <cfg> configuration file instead of FASTLST.CFG.
  464.         
  465.         -f
  466.                 Force compilation even if no new list/diff has been
  467.                 detected.
  468.         
  469.         -i
  470.                 Ignore FastLst.Dat: run as if it were the first time.
  471.                 All nodelists compiled, all exports executed.
  472.         
  473.         -p
  474.                 Prepare: Unarc new lists and diffs, Apply diffs and Arc
  475.                 new nodelists, do not compile nodelists.
  476.         
  477.         -r
  478.                 When applying a diff, FastLst usually deletes the newly
  479.                 generated source nodelist file if a CRC error is
  480.                 detected. With this switch the new nodelist is _not_
  481.                 deleted, so that it will be processed anyway.
  482.         
  483.                 When compiling a list, FastLst usually aborts the
  484.                 compilation of the current output nodelist if a CRC
  485.                 error is detected. With this switch the current output
  486.                 nodelist will be entirely compiled anyway.
  487.         
  488.         -h or -?
  489.                 for help
  490.         
  491.         
  492.                                   ERRORLEVELS
  493.         
  494.         
  495.           0 - Normal termination, something compiled
  496.           1 - Help requested
  497.           2 - File Open error
  498.           3 - Abnormal termination
  499.           4 - Disk Full
  500.           5 - Can't find config file
  501.           6 - Configuration error
  502.           7 - Out of memory
  503.           8 - Read error while applying diff
  504.           9 - CRC error (applying diff)
  505.          10 - CRC error (compiling list)
  506.          11 - User Break
  507.          12 - Cannot rename temporary output nodelist files
  508.          13 - Cannot open source nodelist file
  509.          14 - Timeout waiting on V7+ semaphore
  510.          15 - Too many nodelists in inbound directories
  511.          16 - Nothing found after unarchiving a fixed-name nodelist
  512.          17 - Error Linking output files
  513.         
  514.         100 - Normal termination, nothing compiled
  515.         
  516.         250 - MsgApi: Init Error
  517.         251 - MsgApi: Area Open Error
  518.         252 - MsgApi: Area Lock Error
  519.         253 - MsgApi: Area Close Error
  520.  
  521.         
  522.         
  523.                                  CONFIGURATION
  524.         
  525.         
  526.         Before analyzing the cfg keywords in detail, let's introduce the
  527.         overall mechanism that is at the basis of FastLst's
  528.         configuration.
  529.         
  530.         If you are converting from a different nodelist compiler, please
  531.         forget the old configuration and start from scratch.
  532.         
  533.         FastLst.Cfg is divided into several logical blocks and the
  534.         sequence of the various statements is essential: you cannot just
  535.         put keywords somewhere in the config file; they must be arranged
  536.         in the correct order.
  537.         
  538.         At first, this characteristic of FastLst's configuration might
  539.         appear complex to understand, but, as soon as you will grasp its
  540.         logic, you will understand that it's really easy to write a
  541.         correct configuration file and you will appreciate its
  542.         extraordinary flexibility.
  543.         
  544.         The first block of configuration is the "Global" one.
  545.         The verbs in this block refer to the compilation of all the
  546.         nodelists.
  547.         
  548.         Then there are one or more "Output Blocks": each output block
  549.         refers to the compilation of a single nodelist (e.g.
  550.         NODEX.*).
  551.         
  552.         Each "Output Block" has a "Output section" (with statements
  553.         regarding the compilation of the whole <NODEX>.* list) and one
  554.         or more "Input blocks" containing the verbs that describe how to
  555.         compile each of the source nodelists.
  556.         
  557.         The first "Output Block" can optionally be of a special kind: a
  558.         "NoCompile" block, whose "Input Blocks" describe nodelists that
  559.         must be maintained (e.g. diffs applied) but not compiled to any
  560.         <NODEX>.* list.
  561.         
  562.         Some statements can be used in blocks of a particular type only,
  563.         others can be used in many different places depending on what
  564.         nodelists you want to be affected. As a rule of thumb, you can
  565.         use each statement anywhere it seems to be logically acceptable.
  566.         
  567.         If you feel frightened by such abstract considerations, please
  568.         take a look at the example Fast*.Cfg files, so that you can
  569.         quickly realize it's not that difficult.
  570.         
  571.         To write your own configuration file you should start modifying
  572.         the example one that is more adequate to your needs.
  573.         
  574.         Now, let's consider all the verbs that are allowed in FastLst's
  575.         configuration.
  576.  
  577.         
  578.         
  579.                                  CFG REFERENCE
  580.         
  581.         
  582.         
  583.         - Items between square brackets (e.g. [<item>]) are optional.
  584.         
  585.         - The names of the various Keywords are NOT case sensitive.
  586.         
  587.         - When a directory path is required, the trailing backslash '\'
  588.           is optional.
  589.         
  590.         - The ';' character starts comments: any character following the
  591.           ';' is ignored, unless inside quoted strings.
  592.         
  593.         - The maximum length of configuration lines is 254 characters,
  594.           so don't go further (you can always split address lists into
  595.           smaller ones).
  596.         
  597.         - In the OS/2 version, any file specification can be a legal
  598.           OS/2 name, between double quotes if necessary.
  599.         
  600.         Please, note that the order of the configuration statements
  601.         follows some logical rule. In order not to create confusion in
  602.         the .cfg file and not to break some _necessary_ order relation,
  603.         please follow the scheme proposed in the example Fast*.CFG files
  604.         and in this reference documentation.
  605.         
  606.         Please, be aware that the generation of text files (FidoTxt,
  607.         FidoPrn, FidoUserLst verbs) and the use of lots of options and
  608.         overrides can slow down the compilation process: use only the
  609.         options/overrides that you really need if you mind compilation
  610.         time.
  611.  
  612.         
  613.         
  614.         Include <filename>
  615.         
  616.           You can split the configuration into multiple files, including
  617.           them via this statement, which can be used everywhere and
  618.           nested without limits.
  619.         
  620.         
  621.                                   G L O B A L
  622.         
  623.         
  624.         The following verbs can be used in the Global section of
  625.         FastLst.cfg. Some of them can be used in other places also, so
  626.         they are divided into separate sections.
  627.         
  628.         
  629.         
  630.         
  631.                                   G L O B A L
  632.         
  633.                                    Section A
  634.         
  635.         
  636.         
  637.         The following configuration verbs can be used in the GLOBAL
  638.         section of FastLst.Cfg.
  639.         
  640.         
  641.         RegKey <RegKey>
  642.         
  643.                 Registered Users only: <RegKey> is the registration key
  644.                 and it is NOT case sensitive.
  645.         
  646.             Example:
  647.         
  648.                 RegKey dfhyuwru6274623
  649.         
  650.         
  651.         
  652.         Priority <type> [<level>]
  653.         
  654.                 Changes the execution priority of the FastLst process
  655.                 (OS/2 only).
  656.         
  657.                 Ignored by NT and DOS versions.
  658.         
  659.                 <type> is one of: Idle Regular High
  660.         
  661.                 <level> is an integer in the range 0...31 and defaults
  662.                 to 0.
  663.         
  664.                 If you do not use this statement, FastLst will run at
  665.                 the default priority, which normally is "Regular 0".
  666.         
  667.             Examples:
  668.         
  669.                 Priority High 31
  670.         
  671.                   Gives Fastlst the highest priority for "non
  672.                   time-critical" processes. It will run fast even if it
  673.                   is in the background and other processes are active.
  674.         
  675.         
  676.                 Priority Idle
  677.         
  678.                   Gives FastLst the lowest priority, so that it loads
  679.                   the system as minimally as possible. It will run
  680.                   significantly slower, especially if in the background
  681.                   or when other CPU intensive processes are in
  682.                   execution.
  683.         
  684.         
  685.         
  686.         StatusLog <LogFile>
  687.         
  688.                 <LogFile> is the name of the file where all the
  689.                 operations performed by FastLst will be logged,
  690.                 following the "Binkley Style".
  691.         
  692.                 In multitasking environments, please be sure to use a
  693.                 file that cannot be used by other processes at the same
  694.                 time. For example: if (in your system) FastLst can be
  695.                 executed while Binkley is running, please use different
  696.                 log files.
  697.         
  698.                 Should you not want the log file, you can comment this
  699.                 keyword out.
  700.         
  701.             Example:
  702.         
  703.                 StatusLog d:\bbs\log\FastLst.log
  704.         
  705.         
  706.         
  707.         CompressCfg <compress_cfg>
  708.         
  709.                 This is a "Squish style" compress definition file.
  710.         
  711.                 In the case you are using a case-sensitive
  712.                 de/compression program (e.g. OS/2 ZIP/UNZIP), please
  713.                 make sure to use the correct switches in <compress_cfg>
  714.                 and/or the correct case (Lower/Upper) in <NodeList> and
  715.                 <NodeDiff> specifications.
  716.         
  717.                 You can find the suggested <compress_cfg> in the example
  718.                 Compress.Cfg file included in the FastLst pack.
  719.         
  720.                 If you are already using Squish and/or Maximus, you can
  721.                 just specify the name of their compress.cfg (but do
  722.                 check that they indicate the necessary switches to avoid
  723.                 case sensitiveness during extraction).
  724.         
  725.                 Refer to the "Compress Definition File" section at the
  726.                 end of this document for the syntax of <compress_cfg>.
  727.         
  728.         
  729.         
  730.         InputPath <NodeDir>
  731.         
  732.                 Specifies the default path for input files (source
  733.                 nodelists/nodediffs). You can override it by using a
  734.                 full pathname in input-file specifications.
  735.         
  736.                 Created if not existing.
  737.         
  738.             Example:
  739.         
  740.                 InputPath d:\bbs\nodelist\
  741.         
  742.         
  743.         
  744.         ArcPath <ArcNodeDir>
  745.         
  746.                 Specifies the default path for Archived nodelist files.
  747.                 It usually points to the file area where your TIC
  748.                 processor moves the inbound nodelist archives.
  749.         
  750.                 You can override it by using a full pathname in
  751.                 Archived-file specifications.
  752.         
  753.             Example:
  754.         
  755.                 ArcPath d:\bbs\file\nodelist\
  756.         
  757.         
  758.         
  759.         ArcDate Write|Creation
  760.         
  761.             (OS/2)
  762.                 Selects the date to be used for computing the age of
  763.                 fixed-name archived nodelist files.
  764.         
  765.                 This setting is useful for HPFS (which has separate
  766.                 Write and Creation dates) and ignored for FAT.
  767.         
  768.                 If not specified, "Creation" is assumed.
  769.         
  770.                 Attention: in order to avoid problems in the case the
  771.                 date has been corrupted during the transfer of the file,
  772.                 it is best to choose the same date that your mailer sets
  773.                 as "receive/upload" date or that is touched by your TIC
  774.                 processor.
  775.         
  776.             Examples:
  777.         
  778.                ArcDate Write       ; Use the Write date
  779.                ArcDate Creation    ; same as default
  780.         
  781.         
  782.         
  783.         MultiLineDesc <nnn> [<c>]
  784.         
  785.                 By default, files.bbs description must be on a single
  786.                 line; this statement enables Multi-Line support.
  787.         
  788.                 <nnn> is the number of spaces that must precede the
  789.                 continuation lines.
  790.         
  791.                 <c> is the continuation character.
  792.         
  793.                 If <c> is NOT specified, it is assumed that the
  794.                 continuation lines must be preceded by <nnn> spaces.
  795.         
  796.                 If <c> IS specified, it is assumed that the continuation
  797.                 lines must be preceded by <nnn> spaces, the <c>
  798.                 character and one more space.
  799.         
  800.                 For example, to have the 2nd and following description
  801.                 lines in files.bbs start at the 32nd column, use:
  802.         
  803.                 MultiLineDesc 31
  804.         
  805.                 A description in files.bbs would be like:
  806.         
  807.                 Test.Zip This is the first description line
  808.                                                this is the 2nd line
  809.                                                this is the 3rd line
  810.                 ^                             ^^
  811.                 1                           31  32
  812.         
  813.                 To have the continuation lines preceded by a '|'
  814.                 character, use:
  815.         
  816.                 MultiLineDesc 29 |
  817.         
  818.                 A description in files.bbs would be like:
  819.         
  820.                 Test.Zip This is the first description line
  821.                                              | this is the 2nd line
  822.                                              | this is the 3rd line
  823.                 ^                           ^  ^
  824.                 1                          29  32
  825.         
  826.         
  827.         
  828.         KillAfter
  829.         
  830.                 Old output files are killed after the new ones have been
  831.                 successfully written.
  832.         
  833.                 The new output files are written to temporary names,
  834.                 then the old ones are killed and the new ones renamed
  835.                 (and FastLst retries for 30s in case of error, to be
  836.                 multitasking smart).
  837.         
  838.                 Thus you will always have a valid compiled nodelist,
  839.                 even in the case of a compilation error and consequent
  840.                 compile abortion. Besides, your multitasking system can
  841.                 continue operations while FastLst is working. On the
  842.                 other hand you might need some more spare disk space to
  843.                 hold the old and new files during compilation.
  844.         
  845.         
  846.         
  847.         KillSource
  848.         
  849.                 Tells FastLst to kill all uncompressed nodelists (that
  850.                 are also available in archived format) before
  851.                 terminating.
  852.         
  853.                 Please note that FastLst deletes a source nodelist only
  854.                 if the ArcList statement is defined.
  855.         
  856.                 Besides, when the NodeDiff statement is used, an
  857.                 ArcMethod must be defined to allow the deletion of the
  858.                 nodelist.
  859.         
  860.                 When no NodeDiff is defined, FastLst assumes that the
  861.                 uncompressed NodeList has been extracted from a
  862.                 corresponding archive.
  863.         
  864.         
  865.         
  866.         BeforeKillSource <command>
  867.         
  868.                 This statement is used to invoke a command of your
  869.                 choice before the source nodelists are killed, upon
  870.                 FastLst completion.
  871.         
  872.                 <command> is executed even if "KillSource" is not used.
  873.                 It is a means of invoking a command before FastLst ends.
  874.         
  875.                 The "NeededBeforeKill" verb must be used to specify the
  876.                 NodeLists needed by this command: if one of these
  877.                 nodelists is found new, then this command is invoked
  878.                 after decompressing all the nodelists that have the
  879.                 "NeededBeforeKill" attribute (and have not been
  880.                 decompressed yet).
  881.         
  882.                 IMPORTANT: <command> is executed ONLY if some nodelist
  883.                 affected by a "NeededBeforeKill" verb has been detected
  884.                 as new.
  885.         
  886.                 <command> can be any command that is valid for the
  887.                 command interpreter specified in your COMSPEC
  888.                 environment variable.
  889.         
  890.                 If <command> invokes an executable file, it is loaded
  891.                 and executed directly; otherwise your command
  892.                 interpreter is invoked, so that you can execute a batch
  893.                 file or any other valid command.
  894.         
  895.                 No variable parameters are supported.
  896.         
  897.         
  898.         
  899.         Dash2Comma
  900.         
  901.                 Change dashes to commas in the phone numbers.
  902.         
  903.                 Useful for people that are still connected to ancient
  904.                 "rotary pulse" electromechanic telephone exchanges.
  905.         
  906.         
  907.         
  908.         NoReport
  909.         
  910.                 Do not output nodelist statistics
  911.         
  912.         
  913.         
  914.         NoRedir
  915.         
  916.                 Nodes that do not have a valid phone number (Hold,
  917.                 Unpublished) are usually redirected to their
  918.                 coordinators.
  919.         
  920.                 When this verb is used, redirection does not take place
  921.                 and the node is given an empty phone number, so that you
  922.                 never call a system different from that you think you
  923.                 are calling.
  924.         
  925.                 Please note that (even with no NoRedir verb):
  926.                 - points are never redirected;
  927.                 - if you have a password with a system or its
  928.                   coordinator, this node will never be redirected.
  929.         
  930.         
  931.         
  932.         V7BugFix
  933.         
  934.                 Circumvents a bug with V7 nodelist in Binkley 2.50 (and
  935.                 perhaps in many other programs whose V7 search function
  936.                 was inspired by Binkley's sources) that can sometimes
  937.                 hide segments of V7 nodelist.
  938.         
  939.                 Binkley 2.60 is OK, but some other programs may not: if
  940.                 you are unsure, keep this keyword active.
  941.         
  942.         
  943.         
  944.         MsgLogArea <path> [-$]
  945.         
  946.                 Some information about the compilation can be reported
  947.                 to a fido or squish message area.
  948.         
  949.                 <path> indicates a message area for reporting
  950.                        compilation logs.
  951.         
  952.                 -$     specifies that the area is in Squish format;
  953.                        otherwise it is assumed to be *.MSG.
  954.         
  955.                 The "MsgLog" and "LogStats" statements can be used
  956.                 to add some information that is not reported by default.
  957.         
  958.             Examples:
  959.         
  960.                 MsgLogArea \bbs\mail\net -$
  961.                 MsgLogArea \bbs\mail\net\
  962.         
  963.         
  964.         
  965.         MsgRemArea <path> [-$]
  966.         
  967.                 The comments found in the compiled nodelists can be
  968.                 selectively reported to a fido or squish message area.
  969.         
  970.                 <path> indicates a message area for reporting
  971.                        compilation logs.
  972.         
  973.                 -$     specifies that the area is in Squish format;
  974.                        otherwise it is assumed to be *.MSG.
  975.         
  976.                 The "MsgRem" statement (see Global Section C) MUST be
  977.                 used to specify which types of comments you want to be
  978.                 reported.
  979.         
  980.                 Please note that no comments are reported if no "MsgRem"
  981.                 statement is used.
  982.         
  983.             Examples:
  984.         
  985.                 MsgRemArea \bbs\mail\net -$
  986.                 MsgRemArea \bbs\mail\net\
  987.         
  988.         
  989.         
  990.         MsgFromNode <address>
  991.         MsgToNode <address>
  992.         
  993.                 Specify the addresses for the created messages.
  994.         
  995.                 <address> is a 4D address.
  996.         
  997.             Example:
  998.         
  999.                 MsgFromNode 2:332/504
  1000.                 MsgToNode   2:332/504.1
  1001.         
  1002.         
  1003.         
  1004.         MsgTo <name>
  1005.         
  1006.                 Specifies the name of the addressee of the created
  1007.                 messages.
  1008.         
  1009.             Example:
  1010.         
  1011.                 MsgTo Alberto Pasquale
  1012.         
  1013.         
  1014.         
  1015.         MsgAttr <attributes>
  1016.         
  1017.                 Specifies the attributes for the created messages.
  1018.         
  1019.                 <attributes> can be a (not case sensitive) combination
  1020.                 of:
  1021.         
  1022.                 P : Private
  1023.                 K : Kill/Sent
  1024.                 C : Crash
  1025.                 H : Hold
  1026.                 D : Direct (crash + hold in squish messages)
  1027.         
  1028.             Examples:
  1029.         
  1030.                 MsgAttr P
  1031.                 MsgAttr pk
  1032.         
  1033.         
  1034.         
  1035.         MsgSize <bytes>
  1036.         
  1037.                 Specifies the maximum size of a single message: after
  1038.                 this length, the message is split.
  1039.         
  1040.                 Defaults to 7K, greater values are recommended, so that
  1041.                 the message is not divided into too many parts.
  1042.         
  1043.             Example:
  1044.         
  1045.                 MsgSize 60000
  1046.  
  1047.         
  1048.         
  1049.         CostNullPhone <Cost> [<UCost>]
  1050.         
  1051.                 Specifies the costs to be assigned to nodes with empty
  1052.                 (unpublished, etc.) phone number.
  1053.         
  1054.                 <Cost> is the "call cost" .
  1055.                 <UCost> is the "user cost" (fee for netmail messages).
  1056.         
  1057.                 <UCost> defaults to <Cost>.
  1058.         
  1059.                 If CostNullPhone is not used, <Cost> defaults to 65535
  1060.                 and <UCost> to 0.
  1061.         
  1062.             Example:
  1063.         
  1064.                 CostNullPhone 1000 0
  1065.         
  1066.             Note:
  1067.         
  1068.                 Some programs might have bugs that cause problems
  1069.                 dealing with high costs (such as the default 65535).
  1070.                 Should you experience problems with entries that have a
  1071.                 "NullPhone", try setting a lower cost e.g.
  1072.                 "CostNullPhone 900 0".
  1073.         
  1074.         
  1075.         
  1076.         CostVerbatimPhone <Cost> [<UCost>]
  1077.         
  1078.                 Specifies the costs to be assigned to nodes that have
  1079.                 a verbatim phone specification.
  1080.         
  1081.                 <Cost> is the "call cost" .
  1082.                 <UCost> is the "user cost" (fee for netmail messages).
  1083.         
  1084.                 <UCost> defaults to <Cost>.
  1085.         
  1086.                 If the statement is not used, both costs default to 0.
  1087.         
  1088.             Example:
  1089.         
  1090.                 CostVerbatimPhone 10 0
  1091.         
  1092.         
  1093.         
  1094.                           Dial/Cost translation Table
  1095.         
  1096.         
  1097.         With this table you specify the dial translations and the costs
  1098.         to be applied depending on the phone number.
  1099.         
  1100.         Note: This table is not used against "Verbatim Phones".
  1101.         
  1102.         The table begins with "Dial" and ends with the "End" keyword.
  1103.         
  1104.         Each entry has the following format:
  1105.         
  1106.         <PartPhone> <PreSuf> [<Costs>]
  1107.         
  1108.         
  1109.         The following two keywords allow to specify groups of exchanges
  1110.         that must be handled by a certain dial table entry:
  1111.         
  1112.         
  1113.         LocalValues <PartPhone> <PreSuf> [<Costs>]
  1114.         
  1115.                 This keyword is provided for clarity only: it is
  1116.                 taken just as a normal specification with no
  1117.                 heading "LocalValues".
  1118.         
  1119.         
  1120.         LocalExchanges <num> ...
  1121.         
  1122.                 Lists all the exchanges that must be handled as per the
  1123.                 preceding dial translation entry (which may be preceded
  1124.                 by the "LocalValues" keyword for clarity).
  1125.         
  1126.                 Please remember that the line length is limited to 254
  1127.                 characters.
  1128.         
  1129.                 You can use multiple "LocalExchanges <num> ..."
  1130.                 statements if you like short lines or need more than
  1131.                 254 characters.
  1132.         
  1133.                 Please note that all numbers that (after <PartPhone>
  1134.                 stripping) begin with <num> are considered local.
  1135.                 For example, if 220, 221, 222, 223, 224, 225, 226, 227,
  1136.                 228, 229 are all local exchanges, you can indicate 22 to
  1137.                 include them all.
  1138.         
  1139.         
  1140.         The use of these two statements in the place of a long list of
  1141.         normal table lines (one for each local exchange) should also
  1142.         speed up the processing of all the nodelist entries that are not
  1143.         in your area code.
  1144.         
  1145.         
  1146.         
  1147.         <PartPhone>
  1148.                 is a partial phone number to be matched with the initial
  1149.                 part of nodelist entries. The dashes are ignored. The
  1150.                 <PartPhone> of the last entry must be a single dash "-",
  1151.                 to mean that all the remaining numbers will take the
  1152.                 parameters specified there.
  1153.         
  1154.         <PreSuf>
  1155.                 can be one of:
  1156.                     a: <Prefix>
  1157.                     b: /<Suffix>
  1158.                     c: <Prefix>/<Suffix>
  1159.                     d: /
  1160.         
  1161.                 <PartPhone> is stripped from numbers beginning with it,
  1162.                 then <PreSuf> is used to prepend/append the specified
  1163.                 strings to the remainder.
  1164.         
  1165.                 Case a: <Prefix> is prepended.
  1166.                         e.g.: "39- 0"
  1167.                         strips "39-" and adds "0" at the beginning of
  1168.                         the number.
  1169.         
  1170.                 Case b: <Suffix> is appended.
  1171.                         e.g.: "39-59- /!"
  1172.                         strips "39-59-" and adds "!" at the end of the
  1173.                         number.
  1174.         
  1175.                 Case c: <Prefix> is prepended and <Suffix> appended.
  1176.                         e.g.: "39- 0/!"
  1177.                         strips "39-", adds "0" at the beginning and "!"
  1178.                         at the end.
  1179.         
  1180.                 Case d: Nothing is prepended nor appended.
  1181.                         e.g.: "/"
  1182.                         The slash is needed to allow the correct
  1183.                         interpretation of the subsequent fields.
  1184.         
  1185.                 No spaces are allowed between prefix, suffix and the
  1186.                 separating slash.
  1187.         
  1188.         <Costs>
  1189.         
  1190.         You can specify up to 4 cost fields:
  1191.         
  1192.         <Cost> [<UCost> [<DigCost> [<DigUCost>]]]
  1193.         
  1194.         Each one has a range 0-65535.
  1195.         
  1196.         <Cost>     is the Call cost, default: 65535.
  1197.         <UCost>    is the User cost, default: <Cost>.
  1198.         <DigCost>  is the Digital Call cost, default: <Cost>.
  1199.         <DigUCost> is the Digital User cost.
  1200.         
  1201.         <DigUCost> defaults to <DigCost> if it is specified, otherwise
  1202.         it defaults to <UCost>.
  1203.         
  1204.         If you like your users to send netmail messages from the BBS
  1205.         with no need for "credits", you should set <UCost> and
  1206.         <DigUCost> to 0.
  1207.         
  1208.         When searching for "PartPhone", the first matching entry is
  1209.         applied: in the case of entries with an initial part in common,
  1210.         you have to specify them in sequence from the longest to the
  1211.         shortest. If no match is possible, the last line specifies the
  1212.         default (thereby international) parameters.
  1213.         
  1214.         WARNING: This table CANNOT be left totally empty: it must
  1215.         contain at least the default entry  "- [<PreSuf>]".
  1216.         
  1217.         
  1218.             Example 1a/b/c (North American viewpoint):
  1219.         
  1220.                 There are some groups of phone numbers:
  1221.         
  1222.                 1 - Local numbers.
  1223.                     These are usually "toll free" numbers.
  1224.                     As a rule of thumb, you must only dial the local
  1225.                     number, stripping the Country Code "1" and the
  1226.                     Area Code.
  1227.                     In the case you live at the crossroads of two or
  1228.                     more area codes, it is possible that you have local
  1229.                     numbers in area codes that you must _not_ strip.
  1230.         
  1231.                 2 - Area Code numbers.
  1232.                     They have your same Area Code but they are long
  1233.                     distance.
  1234.                     As far as I know, there are many different
  1235.                     situations regarding the need to dial the long
  1236.                     distance access code "1" and the Area Code.
  1237.                     In any case you usually want to differentiate costs.
  1238.         
  1239.                     The Country "1" and Area Codes must be stripped and
  1240.                     replaced by:
  1241.         
  1242.                     (a) the long distance access code "1"
  1243.                     (b) the long distance access code "1" +
  1244.                         the Area Code
  1245.                     (c) nothing
  1246.         
  1247.                     In case (b) the number really remains untouched.
  1248.         
  1249.                     Even if the Country Code for USA/Canada "1" is
  1250.                     numerically equal to your long distance acces code,
  1251.                     they are conceptually quite different, and so they
  1252.                     will be treated.
  1253.         
  1254.                 3 - Domestic numbers.
  1255.                     USA/Canada numbers, with a leading "1", that is the
  1256.                     international Country Code for USA and Canada.
  1257.                     They must be left untouched, since the american long
  1258.                     distance access code is equal to the international
  1259.                     Country Code for North America.
  1260.         
  1261.                 4 - International numbers.
  1262.                     These are numbers out of USA and Canada.
  1263.                     They must be prefixed by "011", that is the
  1264.                     international access code.
  1265.         
  1266.                 And now let's see how to achieve our goal using
  1267.                 FastLst's Dial Table.
  1268.         
  1269.         
  1270.         
  1271.             Example 1a:
  1272.         
  1273.                 Let's suppose:
  1274.         
  1275.                 - we are in Area Code 414
  1276.                 - the 414 must be stripped for LD calls
  1277.                 - the local exchanges are 231, 232, 233, 235, 236, 424
  1278.         
  1279.         
  1280.                 Dial
  1281.                         ; strip 1-414- from local numbers, do not add
  1282.                         ; a prefix, set call and user costs to 0.
  1283.         
  1284.                   LocalValues 1-414- / 0
  1285.                   LocalExchanges 231 232 233 235 236 424
  1286.         
  1287.                         ; Remaining "1-414-" numbers are long distance:
  1288.                         ; strip the 414 Area Code and assign costs = 25.
  1289.         
  1290.                   1-414-  1-  25
  1291.         
  1292.                         ; Remaining "1-" numbers are Domestic Long
  1293.                         ; Distance.
  1294.                         ; Set costs to 50
  1295.         
  1296.                   1-      1-  50
  1297.         
  1298.                         ; Remaining numbers are international.
  1299.                         ; Prepend 011 and set call cost to 250 and
  1300.                         ; user cost to 500
  1301.         
  1302.                   -       011 250 500
  1303.                 End
  1304.         
  1305.         
  1306.         
  1307.             Example 1b:
  1308.         
  1309.                 Let's suppose:
  1310.         
  1311.                 - we are in Area Code 604
  1312.                 - the 604 must NOT be stripped for LD calls
  1313.                 - the local exchanges are 220 221 222 224 228 230 231
  1314.                   240 241 244 250 251 252 253 254 255 257 258 261 263
  1315.                   264 266
  1316.         
  1317.         
  1318.                 Dial
  1319.                         ; strip 1-604- from local numbers, do not add
  1320.                         ; a prefix, set call and user costs to 0.
  1321.         
  1322.                   LocalValues 1-604- / 0
  1323.                   LocalExchanges 220 221 222 224 228 230 231 240
  1324.                   LocalExchanges 241 244 250 251 252 253 254 255
  1325.                   LocalExchanges 257 258 261 263 264 266
  1326.         
  1327.                         ; Remaining "1-604-" numbers are long distance:
  1328.                         ; assign costs = 25.
  1329.         
  1330.                   1-604-  1-604-  25
  1331.         
  1332.                         ; Remaining "1-" numbers are Domestic Long
  1333.                         ; Distance.
  1334.                         ; Set costs to 50
  1335.         
  1336.                   1-      1-  50
  1337.         
  1338.                         ; Remaining numbers are international.
  1339.                         ; Prepend 011 and set call cost to 250 and
  1340.                         ; user cost to 500
  1341.         
  1342.                   -       011 250 500
  1343.                 End
  1344.         
  1345.         
  1346.         
  1347.             Example 1c:
  1348.         
  1349.                 Let's suppose:
  1350.         
  1351.                 - we are at the crossroads of Area Codes 510, 408, 415
  1352.                 - "1-510" must always be stripped
  1353.                 - "1-408" and "1-415" must never be stripped
  1354.                 - some exchanges are toll-free, others are not
  1355.         
  1356.         
  1357.                 Dial
  1358.                         ; strip 1-510- from local numbers, do not add
  1359.                         ; a prefix, set call and user costs to 0.
  1360.         
  1361.                   LocalValues 1-510- / 0
  1362.                   LocalExchanges 224 225 226 227 247 249 252 264 276
  1363.                   LocalExchanges 278 293 317 353 354 416 417
  1364.         
  1365.                         ; Specify local exchanges for area code 408,
  1366.                         ; keep "1-408".
  1367.         
  1368.                   LocalValues 1-408- 1-408- 0
  1369.                   LocalExchanges 232 251 254 258 259 262 263 272 276
  1370.                   LocalExchanges 321 324 325 383 428 432 433 434
  1371.         
  1372.                         ; Specify local exchanges for area code 415,
  1373.                         ; keep "1-415".
  1374.         
  1375.                   LocalValues 1-415- 1-415- 0
  1376.                   LocalExchanges 233 234 321 322 323 324 325 326 327
  1377.                   LocalExchanges 328 329 354 424 462 473 493
  1378.         
  1379.                         ; Remaining "1-510-" numbers are not free,
  1380.                         ; the country and area codes are stripped.
  1381.         
  1382.                   1-510- /      25
  1383.         
  1384.                         ; Remaining numbers in area codes 408 and
  1385.                         ; 415 are not free, nothing is stripped.
  1386.         
  1387.                   1-408- 1-408- 25
  1388.                   1-415- 1-415- 25
  1389.         
  1390.                         ; Remaining numbers in country code "1"
  1391.                         ; are domestic: nothing changed, cost 100.
  1392.         
  1393.                   1-     1-     100
  1394.         
  1395.                         ; Remaining numbers are international.
  1396.                         ; Prepend 011 and set cost to 2000.
  1397.         
  1398.                   -      011    2000
  1399.         
  1400.                 End
  1401.         
  1402.         
  1403.         
  1404.             Example 2 (European viewpoint):
  1405.         
  1406.                 We differentiate between city, district, domestic and
  1407.                 international.
  1408.         
  1409.                 Dial
  1410.                   LocalValues 39-59- / 5
  1411.                   LocalExchanges 2 3 4 56 81 82    ; city
  1412.                   39-59- /      30   ; district
  1413.                   39-    0      60   ; domestic long distance
  1414.                   43     0043- 100   ; Austria
  1415.                   32     0032- 100   ; Belgium
  1416.                   45     0045- 100   ; Denmark
  1417.                   33     0033- 100   ; France
  1418.                   49     0049- 100   ; Germany
  1419.                   44     0044- 100   ; UK
  1420.                   31     0031- 100   ; Netherlands
  1421.                   34     0034- 100   ; Spain
  1422.                   46     0046- 100   ; Sweden
  1423.                   41     0041- 100   ; Switzerland
  1424.                   1      001-  200   ; USA/Canada
  1425.                   -      00    300   ; others
  1426.                 End
  1427.         
  1428.         
  1429.             Example 3 (Separate Analog/Digital costs):
  1430.         
  1431.                 For people who pay different charges for analog and
  1432.                 digital calls, FastLst allows to specify separate
  1433.                 digital costs (that will be used for nodes that are
  1434.                 given a Digital ModemType).
  1435.         
  1436.                 Let's suppose we want null User Costs and Digital Costs
  1437.                 twice as high as the Analog ones.
  1438.         
  1439.                 Dial
  1440.                   LocalValues 39-59- / 5 0 10 0
  1441.                   LocalExchanges 2 3 4 56 81 82    ; city
  1442.                   39-59- /      30 0  60 0  ; district
  1443.                   39-    0      60 0 120 0  ; domestic long distance
  1444.                   -      00    300 0 600 0  ; international
  1445.                 End
  1446.         
  1447.         
  1448.             Example 4:
  1449.         
  1450.                 Minimal table for sysops that make dial translations and
  1451.                 cost assignments somewhere else.
  1452.         
  1453.                 Dial
  1454.                   -
  1455.                 End
  1456.  
  1457.         
  1458.         
  1459.                                 Modem Type Table
  1460.         
  1461.         
  1462.         This table allows to set the Modem Type, costs and dial
  1463.         translations depending on the nodelist flags.
  1464.         
  1465.         Syntax:
  1466.         
  1467.         TypeDef
  1468.           <Flag> <ModemType> [<Cost> <UCost> [<DialTrans>]]
  1469.           <Flag> <ModemType> [Digital|Analog]
  1470.           ...
  1471.         End
  1472.         
  1473.         <Flag> is a Nodelist flag (max 49 chars),
  1474.         <ModemType> is a number 0->255.
  1475.         
  1476.         The nodelist flags of each node are searched for <Flag>s, in the
  1477.         same order as they are listed in the TypeDef table.
  1478.         
  1479.         The <Flag> must match completely a nodelist flag: if <Flag> is
  1480.         V32 and the nodelist flag is V32B, it's not a match.
  1481.         The search is not case sensitive.
  1482.         
  1483.         The ModemType field of the compiled nodelist will be determined
  1484.         by the first match only: If you define X75 before V34, a node
  1485.         with both V34 and X75 will have a X75 modem type.
  1486.         
  1487.         When <Flag> is for a PSTN system, you can optionally indicate
  1488.         whether it is DIGITAL or ANALOG (which is the default); this is
  1489.         useful for assigning special Digital costs if you have
  1490.         configured them in the Dial/Cost table.
  1491.         
  1492.         When <Flag> is for a non-PSTN system (e.g. internet) you can
  1493.         specify the costs (which override the CostVerbatimPhone) and
  1494.         dial translations.
  1495.         
  1496.         <Cost>  The Call Cost, range: 0-65535
  1497.         <UCost> The User Cost, range: 0-65535
  1498.         
  1499.         <DialTrans> The Dial Translations, for "verbatim" phones.
  1500.         
  1501.             These dial translations DO NOT affect the indexed entry (in
  1502.             <NODEX>.PDX) and are intended as a work around for the dial
  1503.             translations operated by the mailer or the modem-emulator.
  1504.         
  1505.             The syntax requires a set of strings.
  1506.         
  1507.             The first character of each string will be substituted
  1508.             with the remaining characters.
  1509.         
  1510.             A string containing space ' ' or semi-colon ';' MUST be
  1511.             included in quotation marks. If the quotation mark is needed
  1512.             inside the quoted string, it must be double.
  1513.         
  1514.             15 strings of 5 characters are allowed.
  1515.         
  1516.             Example:
  1517.         
  1518.             You need to translate '.' to '*', ':' to ' ', 'v' to
  1519.             'V'; call_cost=100, user_cost=0:
  1520.         
  1521.             Typedef
  1522.               [...]
  1523.               VM 200 100 0 .* ": " vV
  1524.               [...]
  1525.             End
  1526.         
  1527.             You want to translate '.' to '\.', ':' to ' ', 'v' to
  1528.             'V'; call_cost=150, user_cost=100:
  1529.         
  1530.             Typedef
  1531.               [...]
  1532.               VM 200 150 100 .\. ": " vV
  1533.               [...]
  1534.             End
  1535.         
  1536.         
  1537.             Recommended dial translations for Binkley and VMODEM:
  1538.         
  1539.             -\- .* vV ~\~ ": "
  1540.         
  1541.         
  1542.         Full example of TypeDef table:
  1543.         
  1544.                 for USR Courier I-modem + VMODEM:
  1545.         
  1546.         
  1547.                 TypeDef
  1548.                   X75   1   Digital
  1549.                   ISDNC 1   Digital
  1550.                   V120  2   Digital
  1551.                   V120H 2   Digital
  1552.                   V120L 3   Digital
  1553.                   V34   4   Analog
  1554.                   VFC   5   Analog
  1555.                   V32T  6   Analog
  1556.                   H16   7   Analog
  1557.                   V32B  8   Analog
  1558.                   ZYX   8   Analog ; ZYX implies V32B
  1559.                   Z19   8   Analog
  1560.                   Z16   8   Analog
  1561.                   H14   9   Analog
  1562.                   V32   10  Analog
  1563.                   HST   11  Analog
  1564.                   VM    200 100 0 -\- .* vV ~\~ ": " ; VMODEM
  1565.                 End
  1566.         
  1567.         
  1568.             In Binkley.Cfg for the I-modem you can use:
  1569.         
  1570.         
  1571.                 ModemTrans   0
  1572.                 ModemTrans   1 AT*V2=6D/    ; X75
  1573.                 ModemTrans   2 AT*V2=1D/    ; V120
  1574.                 ModemTrans   3 AT*V2=1D/    ; V120L
  1575.                 ModemTrans   4 AT*V2=3B0D/  ; V34
  1576.                 ModemTrans   5 AT*V2=3B0D/  ; VFC
  1577.                 ModemTrans   6 AT*V2=3B0D/  ; V32T
  1578.                 ModemTrans   7 AT*V2=3B1D/  ; H16
  1579.                 ModemTrans   8 AT*V2=3B0D/  ; V32B
  1580.                 ModemTrans   9 AT*V2=3B1D/  ; H14
  1581.                 ModemTrans  10 AT*V2=3B0D/  ; V32
  1582.                 ModemTrans  11 AT*V2=3B1D/  ; HST
  1583.                 ModemTrans 200
  1584.         
  1585.             In Binkley.Cfg for VMODEM you can use:
  1586.         
  1587.         
  1588.                 ModemTrans   0
  1589.                 ModemTrans   1
  1590.                 ModemTrans   2
  1591.                 ModemTrans   3
  1592.                 ModemTrans   4
  1593.                 ModemTrans   5
  1594.                 ModemTrans   6
  1595.                 ModemTrans   7
  1596.                 ModemTrans   8
  1597.                 ModemTrans   9
  1598.                 ModemTrans  10
  1599.                 ModemTrans  11
  1600.                 ModemTrans 200 ATDT#/   ; VMODEM
  1601.         
  1602.         
  1603.  
  1604.         
  1605.         
  1606.                                 User Flags Table
  1607.         
  1608.         
  1609.         This is an optional table used to handle the "user defined" bits
  1610.         in the Flags word of the compiled nodelist entry.
  1611.         
  1612.         These bits are named 5,6,7,8,9,A,B,D,E,F where bit 5 is the 6th
  1613.         bit and F is the 16th bit of the word.
  1614.         
  1615.         Using this table, you can associate (source) nodelist flags to
  1616.         user defined bits in the output binary nodelist.
  1617.         
  1618.         The table is delimited by the "FlagDef" and "End" keywords; each
  1619.         line is in the form "<sFlag> <bFlags>" where <sFlag> is a flag
  1620.         (max 9 chars) to be looked for in the source nodelists while
  1621.         <bFlags> represents one or more user-defined bits in the output
  1622.         Flags word.
  1623.         
  1624.             Example:
  1625.         
  1626.                 FlagDef
  1627.                   V42B  AB  ; V42B -> user bits A and B
  1628.                   V32B  DE  ; V32B -> user bits D and E
  1629.                 End
  1630.         
  1631.         
  1632.         To add further flags on a node by node basis, please use the
  1633.         "Flags <Addr> <Flags>" statement.
  1634.         
  1635.         To remove flags, please specify the source flags via the
  1636.         "NodeFlags <Addr> <NodeFlags>" statement.
  1637.         
  1638.         
  1639.         
  1640.                                   G L O B A L
  1641.         
  1642.                                    Section B
  1643.         
  1644.         
  1645.         
  1646.         The statements in this section affect the processing of all
  1647.         the output blocks and thereby of all the input nodelists.
  1648.         
  1649.         These statements can also be used in the "OUTPUT" section of an
  1650.         OUTPUT block or inside an INPUT block, in which case they affect
  1651.         the compilation of the relevant block only.
  1652.         
  1653.         In the case you use a verb that has already been used in a
  1654.         "higher level" block, it will behave as a local override.
  1655.         
  1656.         
  1657.         
  1658.         NeededBeforeKill
  1659.         
  1660.                 Tells FastLst that the affected NodeList(s) are needed
  1661.                 by the command run via the "BeforeKillSource" statement.
  1662.         
  1663.                 The "BeforeKillSource" verb allows you to run a command
  1664.                 (executable or batch file) after the compilation has
  1665.                 completed, just before FastLst ends and (if "KillSource"
  1666.                 is used) deletes the source files that are also present
  1667.                 in archived form.
  1668.         
  1669.                 The lists affected by "NeededBeforeKill" are extracted,
  1670.                 if not already present, before the "BeforeKillSource"
  1671.                 command is executed.
  1672.         
  1673.         
  1674.         
  1675.         ArcMethod <meth>[,<f>] ...
  1676.         
  1677.                 Tells FastLst that it must make sure that all new
  1678.                 nodelists are archived using the specified methods.
  1679.                 The original archive is NOT killed.
  1680.         
  1681.                 Obviously, a new nodelist is not rearchived to its
  1682.                 original method.
  1683.         
  1684.                 <meth> is the name of an archiver defined in
  1685.                 compress.cfg.
  1686.         
  1687.                 <f> is the optional specification of the letter to be
  1688.                 used for the variable archive extension. If not
  1689.                 specified, it is assumed equal to the first letter of
  1690.                 the defaults extension for this archiver.
  1691.         
  1692.                 Multiple ArcMethod statements are allowed.
  1693.         
  1694.         
  1695.             Example 1:
  1696.         
  1697.                 ArcMethod ZIP LH,H
  1698.         
  1699.                 NodeList.Z48 arrives: it is archived to NodeList.H48
  1700.                 also, using the LH archiver.
  1701.         
  1702.         
  1703.             Example 2:
  1704.         
  1705.                 ArcMethod ZIP LH
  1706.         
  1707.                 NodeDiff.Z48 arrives: the resulting nodelist is archived
  1708.                 to NodeList.Z48 using the ZIP archiver and to
  1709.                 NodeList.L48 using LH.
  1710.         
  1711.         
  1712.         
  1713.         ArcDiffMethod <meth>[,<f>] ...
  1714.         
  1715.                 Tells FastLst that it must make sure that all new
  1716.                 nodediffs are archived using the specified methods.
  1717.                 The original archive is NOT killed.
  1718.         
  1719.                 Obviously, a new nodediff is not rearchived to its
  1720.                 original method.
  1721.         
  1722.                 <meth> is the name of an archiver defined in
  1723.                 compress.cfg.
  1724.         
  1725.                 <f> is the optional specification of the letter to be
  1726.                 used for the variable archive extension. If not
  1727.                 specified, it is assumed equal to the first letter of
  1728.                 the defaults extension for this archiver.
  1729.         
  1730.                 Multiple ArcDiffMethod statements are allowed.
  1731.         
  1732.         
  1733.             Example:
  1734.         
  1735.                 ArcDiffMethod ZIP LH,H
  1736.         
  1737.                 NodeDiff.Z48 arrives: it is archived to NodeDiff.H48
  1738.                 also, using the LH archiver.
  1739.         
  1740.         
  1741.         
  1742.         
  1743.                                EXTERNAL COMMANDS
  1744.         
  1745.         
  1746.         The following verbs allow to invoke external commands.
  1747.         
  1748.         <command> can be any legal command-line command: it can be the
  1749.         name of an executable file, a batch file or any command that can
  1750.         be understood by your command-line interpreter (OS/2's CMD,
  1751.         4OS2, etc.).
  1752.         
  1753.         If <command> does not directly invoke an executable file,
  1754.         FastLst automatically invokes your default command line
  1755.         interpreter (as specified by the COMSPEC environment variable).
  1756.         
  1757.         
  1758.                             Archive Related Commands
  1759.         
  1760.         
  1761.         The following verbs share the same syntax:
  1762.         
  1763.         Two parameters are allowed in <command>:
  1764.         
  1765.         %a is translated to the full pathname of the archive file.
  1766.         
  1767.         %f is translated to the name of the file to be added or
  1768.            extracted (no path).
  1769.         
  1770.         <command> is run from the path where %f belongs.
  1771.         
  1772.         
  1773.         
  1774.         BeforeArcList <command>
  1775.         
  1776.                 Command to be run before archiving a nodelist.
  1777.         
  1778.         
  1779.         AfterArcList <command>
  1780.         
  1781.                 Command to be run after archiving a nodelist.
  1782.         
  1783.         
  1784.         BeforeUnArcList <command>
  1785.         
  1786.                 Command to be run before extracting a nodelist.
  1787.         
  1788.         
  1789.         AfterUnArcList <command>
  1790.         
  1791.                 Command to be run after extracting a nodelist.
  1792.         
  1793.         
  1794.         BeforeArcDiff <command>
  1795.         
  1796.                 Command to be run before archiving a nodediff.
  1797.         
  1798.         
  1799.         AfterArcDiff <command>
  1800.         
  1801.                 Command to be run after archiving a nodediff.
  1802.         
  1803.         
  1804.         BeforeUnArcDiff <command>
  1805.         
  1806.                 Command to be run before extracting a nodediff.
  1807.         
  1808.         
  1809.         AfterUnArcDiff <command>
  1810.         
  1811.                 Command to be run after extracting a nodediff.
  1812.         
  1813.         
  1814.                                     Example
  1815.         
  1816.         To hatch the new nodelist (note that you probably need to
  1817.         specify the location of the config file since the command is
  1818.         executed from the directory where %f resides):
  1819.         
  1820.           AfterArcList Hatch %a NODELIST "New NodeList"
  1821.         
  1822.         
  1823.         
  1824.                            NodeDiff Related Commands
  1825.         
  1826.         
  1827.         The following verbs accept different parameters:
  1828.         
  1829.         %l is translated to the full pathname of the nodelist.
  1830.         
  1831.         %d is translated to the full pathname of the nodediff.
  1832.         
  1833.         <command> is run from the current directory.
  1834.         
  1835.         
  1836.         
  1837.         BeforeEdit <command>
  1838.         
  1839.                 Command to be run before applying a nodediff.
  1840.         
  1841.         
  1842.         AfterEdit <command>
  1843.         
  1844.                 Command to be run after applying a nodediff.
  1845.                 Only %l can be used.
  1846.         
  1847.         
  1848.         
  1849.                                   G L O B A L
  1850.         
  1851.                                    Section C
  1852.         
  1853.         
  1854.         
  1855.         The statements in this section affect the processing of all
  1856.         the output blocks and thereby of all the input nodelists.
  1857.         
  1858.         These statements can also be used in the "OUTPUT" section of an
  1859.         OUTPUT block (except for the "NoCompile" one) or inside an INPUT
  1860.         block, in which case they affect the compilation of the relevant
  1861.         block only.
  1862.         
  1863.         In the case you use a verb that has already been used in a
  1864.         "higher level" block, it will behave as a local override.
  1865.         
  1866.         
  1867.         
  1868.         MsgRem [<string>]
  1869.         
  1870.                 If MsgRemArea is used, FastLst reports the following
  1871.                 comments:
  1872.         
  1873.                 No MsgRem statement: none;
  1874.         
  1875.                 MsgRem with no <string>: all;
  1876.         
  1877.                 MsgRem with <string>: only the comments that begin with
  1878.                 ";<l> " where <l> is one of the characters in <string>.
  1879.         
  1880.                 The ";" character in <string> means that the comments
  1881.                 beginning with "; " or ";<word>" can be reported.
  1882.         
  1883.                 Common types of comment lines:
  1884.         
  1885.                 ;S This is a comment for SysOps
  1886.                 ;U This is a comment for users
  1887.                 ;F This comment should appear in formatted Fido lists
  1888.                 ;A This is a comment of general interest
  1889.                 ;E This comment is an error message
  1890.         
  1891.             Example:
  1892.         
  1893.                 "MsgRem SE"
  1894.         
  1895.                 Only comments destined to SysOps and Error messages are
  1896.                 reported (lines beginning with ";S " and ";E ").
  1897.         
  1898.         
  1899.         
  1900.         MsgLog [NullPhone] [Redirected] [Points]
  1901.         
  1902.                 Some common situations (not really errors) are not
  1903.                 reported to MsgLogArea by default: if you want FastLst
  1904.                 to report them anyway, you can use this statement, but
  1905.                 be aware that very long reports could come out.
  1906.         
  1907.                 "NullPhone": systems with empty phone string are logged.
  1908.         
  1909.                 "Redirected": systems redirected to their coordinators
  1910.                 are logged (Hold, unpublished).
  1911.         
  1912.                 "Points": points with empty phone string are logged; be
  1913.                 aware that most pointlists contain unpublished (thereby
  1914.                 with empty phone) points.
  1915.         
  1916.           Examples:
  1917.         
  1918.                 MsgLog Redirected
  1919.                 MsgLog Redirected NullPhone
  1920.         
  1921.         
  1922.         
  1923.         GermanPointList
  1924.         
  1925.                 Instructs FastLst to consider the affected nodelist as a
  1926.                 3D German style pointlist. Zone 2 is assumed, if not
  1927.                 explicitly specified in the "NodeList" statement.
  1928.         
  1929.                 This verb is usually used inside an Input Block, so that
  1930.                 it affects that nodelist only.
  1931.         
  1932.                 WARNING: Be aware that using this statement in the
  1933.                 global section or in an Output block affects all the
  1934.                 involved nodelists !
  1935.         
  1936.             Example Input Block:
  1937.         
  1938.                 NodeList Points24.???
  1939.                   GermanPointList
  1940.                   Nodediff Pr24Diff.???
  1941.                   ArcList Points24.??? 1
  1942.                   ArcDiff Pr24Diff.??? 5
  1943.                   ArcListDesc R24 PointList for day %d (%D), %a format
  1944.                   ArcDiffDesc R24 PointDiff for day %d (%D), %a format
  1945.         
  1946.         
  1947.         
  1948.         NoPointLstPhone
  1949.         
  1950.                 Changes to "-Unpublished-" the phone numbers specified
  1951.                 in the PointLists (German or "Boss" styles).
  1952.         
  1953.                 If you use Squish and Binkley, you usually will like
  1954.                 pointlists with the Boss' phone in the point entries
  1955.                 (otherwise a crash message to a point will have to be
  1956.                 manually readdressed to its Boss).
  1957.         
  1958.                 But if you use a netmail manager (as NmFwd) that already
  1959.                 routes the crash messages for points that do not have a
  1960.                 phone to their Boss, then you will probably like this
  1961.                 statement.
  1962.         
  1963.                 You will usually find convenient to use this statement
  1964.                 in the global section, so that it is valid for all the
  1965.                 nodelists.
  1966.         
  1967.         
  1968.         
  1969.         BeforeCompile <command>
  1970.         
  1971.                 Command to be run before compiling the affected
  1972.                 nodelist.
  1973.         
  1974.                 This statement follows the same rules explained in
  1975.                 "External Commands" in section B.
  1976.         
  1977.                 The %l parameter is translated to the full pathname of
  1978.                 the nodelist.
  1979.         
  1980.                 <command> is run from the current directory.
  1981.         
  1982.         
  1983.         
  1984.         AfterCompile <command>
  1985.         
  1986.                 Command to be run after compiling the affected nodelist.
  1987.         
  1988.                 This statement follows the same rules explained in
  1989.                 "External Commands" in section B.
  1990.         
  1991.                 The %l parameter is translated to the full pathname of
  1992.                 the nodelist.
  1993.         
  1994.                 <command> is run from the current directory.
  1995.         
  1996.         
  1997.         
  1998.         FidoTxt [<FidoTxt>]
  1999.         
  2000.                 Generate an 80 Column Text List of nodes.
  2001.                 Nodes included via the "Node,..." method and points are
  2002.                 excluded.
  2003.         
  2004.                 <FidoTxt> optionally specifies an output file name,
  2005.                 which defaults to "NodeList.Txt". If the same file name
  2006.                 has already been used for other nodelists, the output is
  2007.                 appended.
  2008.         
  2009.             Example:
  2010.         
  2011.                 FidoTxt
  2012.         
  2013.         
  2014.         
  2015.         FidoPrn [<FidoPrn>]
  2016.         
  2017.                 Generate a 132 Column Text List of nodes.
  2018.                 Nodes included via the "Node,..." method and points are
  2019.                 excluded.
  2020.         
  2021.                 <FidoPrn> optionally specifies an output file name,
  2022.                 which defaults to "NodeList.Prn". If the same file name
  2023.                 has already been used for other nodelists, the output is
  2024.                 appended.
  2025.         
  2026.             Example:
  2027.         
  2028.                 FidoPrn
  2029.         
  2030.         
  2031.         
  2032.         IncCoord <CoordLev>
  2033.         
  2034.                 The coordinators of the specified and upper levels will
  2035.                 be always included, even if excluded by "IncAddr" and
  2036.                 "ExcAddr". <CoordLev> can be ZC, RC, NC, HC.
  2037.         
  2038.             Example:
  2039.         
  2040.                 IncCoord NC
  2041.         
  2042.         
  2043.         
  2044.                              Global Export Section
  2045.         
  2046.         
  2047.         You can use here the statements described in the "Export Global
  2048.         Section" of the "Export Block" (see "Input Block" inside "Output
  2049.         Block").
  2050.         
  2051.  
  2052.         
  2053.         
  2054.                             O U T P U T   B L O C K
  2055.         
  2056.         
  2057.         
  2058.         The following verbs define the compilation of a single output
  2059.         binary nodelist.
  2060.         
  2061.         The block begins with a "Output Section", that affects the
  2062.         compilation of all the source (input) nodelists, followed by a
  2063.         sequence of "Input Blocks" that define how to handle each of the
  2064.         source nodelists.
  2065.         
  2066.         The first "output block" can be of a special kind: if the
  2067.         "NoCompile" statement is used instead of "Version7+", this block
  2068.         indicates the actions necessary to maintain the specified
  2069.         nodelists, but they are not compiled.
  2070.         
  2071.         
  2072.         
  2073.         Version7[+] <Path> <Nodex> [<Sysop>[.<Ext>]]
  2074.         
  2075.                 Start of a block of config verbs defining the generation
  2076.                 of an output nodelist. You can generate one or more
  2077.                 compiled nodelists with different names and path for the
  2078.                 output files. Each "Version7" statement marks the
  2079.                 beginning of a new output-nodelist definition.
  2080.         
  2081.                 Version7+ is for V7+ while Version7 allows to save space
  2082.                 and generate the V7 files only.
  2083.         
  2084.                 <Path> is the path where the output binary data and
  2085.                 index files are placed.
  2086.         
  2087.                 <Nodex> is the file name (no extension) for the output
  2088.                 files.
  2089.         
  2090.                 <Sysop>.<Ext> is the file name for the sysop-index.
  2091.                 When no extension is given, .NDX is assumed if
  2092.                 <Sysop> is different from <Nodex>, otherwise the .SDX
  2093.                 extension is used.
  2094.         
  2095.                 If you omit <Sysop> with Version7+, <Nodex>.SDX is used
  2096.                 for the SysOp index.
  2097.         
  2098.                 If you omit <Sysop> with Version7, no SysOp index is
  2099.                 generated.
  2100.         
  2101.                 Usually <Nodex> should be "NODEX" and <Sysop> "SYSOP".
  2102.         
  2103.                 If you use V7+ and all of your applications accept
  2104.                 <NODEX>.SDX as the SysOp index, you may omit <Sysop>.
  2105.         
  2106.                 For compatibility with V7 applications that require
  2107.                 "SYSOP.NDX" as SysOp index, "SYSOP" is recommended for
  2108.                 <SysOp>.
  2109.         
  2110.                 All the following verbs, up to the next "Version7" (if
  2111.                 any), are related to the preceding "Version7" output
  2112.                 files.
  2113.         
  2114.             Examples:
  2115.                                                    ; SysOp Index name
  2116.                 Version7+ d:\bbs\v7\ NODEX  SYSOP  ; SYSOP.NDX
  2117.                 Version7+ d:\bbs\v7\ NODEX  NODEX  ; NODEX.SDX
  2118.                 Version7+ d:\bbs\v7\ NODEX         ; NODEX.SDX
  2119.                 Version7  d:\bbs\v7\ NODEX  SYSOP  ; SYSOP.NDX
  2120.                 Version7  d:\bbs\v7\ NODEX  NODEX  ; NODEX.SDX
  2121.                 Version7  d:\bbs\v7\ NODEX         ; no index
  2122.         
  2123.             Version7 Output files:
  2124.                 <Nodex>.DAT     Nodelist Data
  2125.                 <Nodex>.NDX     Address Index
  2126.                 <Sysop>.NDX     SysOp Index (optional)
  2127.         
  2128.                 Some Version7 programs also accept <Nodex>.SDX for the
  2129.                 SysOp Index.
  2130.         
  2131.             Version7+ Output files:
  2132.                 <Nodex>.DAT     Nodelist Data
  2133.                 <Nodex>.DTP     Additional Data
  2134.                 <Nodex>.NDX     Address Index
  2135.                 <Nodex>.SDX     SysOp Index
  2136.                 <Nodex>.PDX     Phone Index
  2137.         
  2138.                 Version7+ programs must also be configurable to accept
  2139.                 <Sysop>.NDX as the SysOp Index for compatibility with V7
  2140.                 programs.
  2141.         
  2142.         
  2143.         NoCompile
  2144.         
  2145.                 This verb can be used to start the first "Output Block",
  2146.                 instead of "Version7".
  2147.         
  2148.                 This way the first output block becomes a "NoCompile"
  2149.                 block and the indicated nodelists are maintained but not
  2150.                 compiled.
  2151.         
  2152.                 This is a means for maintaining a NodeList (applying
  2153.                 nodediffs, archiving with different archivers etc.)
  2154.                 without compiling it.
  2155.         
  2156.                 The statements related to nodelist compilation (see
  2157.                 Global section C) are obviously illegal in a "NoCompile"
  2158.                 block.
  2159.         
  2160.         
  2161.         
  2162.         
  2163.                              O U T P U T   Section
  2164.         
  2165.         
  2166.         The following verbs affect the compilation of the current output
  2167.         block and must precede the definitions of the input blocks
  2168.         (which start with the Nodelist statement).
  2169.         
  2170.         
  2171.         FidoUserLst [<FidoUserLst>]
  2172.         
  2173.                 Generate "fidouser.lst style" text SysOp list.
  2174.                 <FidoUserLst> optionally specifies an output file name,
  2175.                 which defaults to "FidoUser.Lst". Different output
  2176.                 blocks require different names.
  2177.         
  2178.             Example:
  2179.         
  2180.                 Version7+ d:\bbs\v7 NODEX SYSOP
  2181.                    FidoUserLst
  2182.         
  2183.         
  2184.         
  2185.         LinkOnDisk
  2186.         
  2187.                 Forces "on disk" DTP linking.
  2188.         
  2189.                 This can be useful to avoid FastLst using virtual memory
  2190.                 for linking the <NODEX>.DTP file.
  2191.         
  2192.                 If you do not have enough free physical memory (12MB for
  2193.                 60,000 nodes), the "on disk" mode is faster.
  2194.         
  2195.             Example:
  2196.         
  2197.                 Version7+ d:\bbs\v7 NODEX
  2198.                    LinkOnDisk
  2199.         
  2200.         
  2201.         
  2202.         LogStats
  2203.         
  2204.                 Output Statistics to MsgLogArea.
  2205.         
  2206.                 This statements makes FastLst write the statistics for
  2207.                 the current output-nodelist to the area specified with
  2208.                 MsgLogArea.
  2209.         
  2210.             Example:
  2211.         
  2212.                 Version7+ ...
  2213.                   LogStats
  2214.         
  2215.         
  2216.         
  2217.                                 Block Specifications
  2218.         
  2219.         
  2220.         You can use here the same statements described in the "Global
  2221.         Section B" and (if this is not a "NoCompile" block) "Global
  2222.         Section C" and "Export Global Section" (see the Export Block
  2223.         below).
  2224.         
  2225.         
  2226.         
  2227.                              ADDRESS SPECIFIC STUFF
  2228.         
  2229.         
  2230.         
  2231.         The following verbs define address specific stuff that will
  2232.         affect the compilation of all the source nodelists compiled in
  2233.         the current output block. These statements are illegal in a
  2234.         "NoCompile" block.
  2235.         
  2236.         If you prefer, you can specify this type of information in the
  2237.         "Address Specific Stuff" section of the pertinent input block.
  2238.         
  2239.         WARNING: make sure all addresses have full info (incl. zone).
  2240.         
  2241.         
  2242.         
  2243.         Password <Addr> <Password>
  2244.         
  2245.                 Allows to specify <Password> one <Addr> at a time.
  2246.         
  2247.                 Version 7 has no limit on password length, however the
  2248.                 programs that use it are usually limited to 8 chars.
  2249.                 Some (rare) programs have problems with 8 chars and need
  2250.                 a maximum of 7 or 6 chars.
  2251.         
  2252.             Example:
  2253.         
  2254.                 Password 2:332/504.4 Password
  2255.         
  2256.         
  2257.         
  2258.         PasswordFile <PasswordFile>
  2259.         
  2260.                 Allows to include a password file that contains many
  2261.                 address/password couples, one per line.
  2262.         
  2263.                 In this file you can omit the "Password" keyword.
  2264.         
  2265.                 If you like, you can use some "Password" keywords
  2266.                 together with one or more "PasswordFile".
  2267.         
  2268.                 Please note that the definitions found in this file have
  2269.                 effect on the current (Output or Input) block ONLY.
  2270.         
  2271.                 FastLst writes to the log file which source or output
  2272.                 nodelist is affected by each passwordfile; so, in case
  2273.                 of doubts, just check the logs.
  2274.         
  2275.             Example:
  2276.         
  2277.                 PasswordFile fidonet.pwd
  2278.         
  2279.         
  2280.         
  2281.         Phone <Addr> <Phone> [<NodeFlags> [<Cost> [<UCost>]]]
  2282.         
  2283.                 Allows to override a nodelist phone number and
  2284.                 optionally the corresponding "NodeFlags" and costs.
  2285.         
  2286.                 if <Phone> contains non-numeric characters, it is taken
  2287.                 verbatim
  2288.         
  2289.                 If <Phone> contains only digits and dashes '-', it is
  2290.                 considered a PSTN number and MUST be in the form used in
  2291.                 the source nodelist (dial translation will be applied
  2292.                 normally).
  2293.         
  2294.                 <NodeFlags> has the same meaning as in the NodeFlags
  2295.                 statement. To specify an overriding empty <NodeFlags>,
  2296.                 use a single comma.
  2297.         
  2298.                 <Cost> and <UCost> have the same meaning as in the Cost
  2299.                 statement.
  2300.         
  2301.         
  2302.             Examples:
  2303.         
  2304.                 <Phone> override only:
  2305.                 Phone 2:332/501.1 39-59-399999      ; Normal override
  2306.                 Phone 1:106/2000  juge.com          ; internet address
  2307.                 Phone 1:123/4567  123.456.789.012   ; IP address
  2308.                 Phone 2:245/6789  "Bob.scr"         ; quoted script name
  2309.         
  2310.                 <Phone> and <NodeFlags> overrides:
  2311.         
  2312.                 Phone 2:332/501.0 39-59-499999 V34,CM ; Set new flags
  2313.                 Phone 2:332/501.1 39-59-399999 ,      ; Set NO flags
  2314.         
  2315.                 <Phone>, <NodeFlags> and <Cost>/<UCost> overrides:
  2316.         
  2317.                 Phone 2:332/501 39-59-499999 V34,CM 10 0
  2318.                 Phone 2:332/502 mega.com VM 0      ; <Cost> == <UCost>
  2319.         
  2320.         
  2321.         
  2322.         NodeFlags <Addr> <NodeFlags>
  2323.         
  2324.                 Allows to substitute the flags listed in the nodelist
  2325.                 entry of <Addr>.
  2326.         
  2327.                 If you want to change the CM flag or modem type flags
  2328.                 (HST, V32b, ZYX) etc, you can use this verb. Please note
  2329.                 that the old flags are lost, so you need to indicate all
  2330.                 the necessary flags.
  2331.         
  2332.                 Please note that <NodeFlags> might be empty.
  2333.         
  2334.             Example:
  2335.         
  2336.                 NodeFlags 2:332/501.0 CM,H16,V32b
  2337.         
  2338.         
  2339.         
  2340.         Flags <Addr> <Flags>
  2341.         
  2342.                 The Flags statement allows to set the "user defined"
  2343.                 bits in the Flags word of the compiled nodelist entry.
  2344.                 These bits are named 5,6,7,8,9,A,B,D,E,F where bit 5 is
  2345.                 the 6th bit and F is the 16th bit of the word.
  2346.         
  2347.                 These bits are "ORed" with those already set by the
  2348.                 "FlagDef" table.
  2349.         
  2350.                 If you need to zero some of the bits, please specify the
  2351.                 source flags with the "NodeFlags" statement.
  2352.         
  2353.             Example:
  2354.         
  2355.                 Flags 2:332/501.0 AB5   ; Set bits 5,A & B.
  2356.         
  2357.         
  2358.         
  2359.         Cost <Addr> <Cost> [<UCost>]
  2360.         
  2361.                 <Cost> and <UCost> are in the range 0->65535.
  2362.                 Overrides the Cost and User_Cost fields of <Addr> in the
  2363.                 compiled nodelist. If no <UCost> is given, it's taken
  2364.                 equal to <Cost>.
  2365.         
  2366.             Example:
  2367.         
  2368.                 Cost 2:332/501.0 150
  2369.  
  2370.         
  2371.         
  2372.                                SEGMENT SELECTION
  2373.         
  2374.         
  2375.         The following verbs allow to include or exclude selected
  2376.         <NodeList> segments. If you do not use them, the full <NodeList>
  2377.         is compiled. Be aware that the process of checking each address
  2378.         against the list of segments to be included or excluded might
  2379.         slow down the compilation, even if some gain could come from the
  2380.         exclusion of large segments.
  2381.         
  2382.         These statements are obviously illegal in a "NoCompile" block.
  2383.         
  2384.         These statements can be used in an Input block to affect that
  2385.         nodelist only.
  2386.         
  2387.         
  2388.         
  2389.         IncAddr <PartAddrLst>
  2390.         
  2391.                 If you want to selectively include nodelist segments,
  2392.                 you can use this option: only zones, regions, nets,
  2393.                 hubs, nodes, points that are listed in <PartAddrLst>
  2394.                 will be present in the output files. You can specify
  2395.                 zone, region/net, hub/node and point numbers.
  2396.         
  2397.             Example:
  2398.         
  2399.                 IncAddr 1 2:33 2:200/100 3:632 4:801/17
  2400.         
  2401.                   Compiles: zone 1, region 33 of zone 2, hub 100 of net
  2402.                   200 of zone 2, net 632 of zone 3, node 4:801/17
  2403.         
  2404.         
  2405.         
  2406.         ExcAddr <PartAddrLst>
  2407.         
  2408.                 If you want to exclude some segments from the
  2409.                 compilation, you can list them in <PartAddrLst>, in the
  2410.                 same way as for "IncAddr". You can use either "IncAddr"
  2411.                 or "ExcAddr" or both of them to Include only selected
  2412.                 segments and exclude sub-segments.
  2413.         
  2414.             Example:
  2415.         
  2416.                 ExcAddr 2:332/500
  2417.         
  2418.                   Excludes Hub 500 of net 332 of zone 2.
  2419.         
  2420.         
  2421.  
  2422.         
  2423.         
  2424.                              I N P U T   B L O C K
  2425.         
  2426.         
  2427.         The Input Block starts with a "NodeList" statement and continues
  2428.         until the start of the next Input or Output Block (NodeList or
  2429.         Version7 statement respectively) or the end of the configuration
  2430.         file.
  2431.         
  2432.         
  2433.         
  2434.         NodeList <NodeList> [<PartAddr> [<Region> [<Hub>]]]
  2435.         
  2436.                 Start of a block of config verbs defining the processing
  2437.                 of the specified <NodeList> file. You can use many
  2438.                 "NodeList" statements to compile several different
  2439.                 source nodelists into the same output files specified by
  2440.                 the preceding "Version7+" statement. Each "NodeList"
  2441.                 verb marks the beginning of a new input-nodelist
  2442.                 processing-info block.
  2443.         
  2444.                 When an address is present in more than one <NodeList>
  2445.                 (e.g. you compile both the full nodelist and the faster
  2446.                 updated local region or zone segment) only the entry
  2447.                 found in the last compiled <NodeList> is put in the
  2448.                 indices. To have the most up-to-date entries in your V7
  2449.                 indices, please include local segments after the larger
  2450.                 list.
  2451.         
  2452.                 <NodeList> is the name of the input nodelist.
  2453.                 If you don't specify a path, <InputPath> is assumed.
  2454.         
  2455.                 If a terminal ".???" is specified, all the files with 3
  2456.                 digits in the place of '???' are examined and that with
  2457.                 the latest 3 digit day of the year is chosen for
  2458.                 compilation.
  2459.         
  2460.                 The optional <PartAddr> is a partial address that must
  2461.                 be specified for nodelist segments that do not have full
  2462.                 address info. For example, a REGION segment usually
  2463.                 starts with the "Region," keyword and does not contain
  2464.                 any Zone info: its up to you to tell FastLst which zone
  2465.                 we are talking about. For the same reason you should
  2466.                 provide zone and net info when compiling a Hub segment.
  2467.         
  2468.                 For Net segments you should also specify the <Region>
  2469.                 and for simple lists of nodes or points the <Hub>.
  2470.         
  2471.                 Anyway FastLst is smart enough to automagically gather
  2472.                 Region and Hub information (when possible) from:
  2473.         
  2474.                 - same node present in a larger segment (Region and Hub)
  2475.                 - other node with same zone:net (Region only)
  2476.                 - Boss of the point (Region and Hub)
  2477.         
  2478.                 Note: points that do not have a Boss are removed from
  2479.                 the indices.
  2480.         
  2481.             Examples:
  2482.         
  2483.                 IMPORTANT: Please note that the following lines
  2484.                     represent a list of examples, NOT an example of
  2485.                     multiple nodelist compilation.
  2486.                     After each "NodeList" verb, you must specify all the
  2487.                     statements that affect the compilation of that
  2488.                     particular source file.
  2489.         
  2490.         
  2491.              1) NodeList nodelist.???     ; Fidonet nodelist
  2492.         
  2493.              2) NodeList region.033 2     ; Region 33 list, zone 2
  2494.         
  2495.              3) NodeList region24.??? 2   ; Region 24 list, zone 2
  2496.         
  2497.              4) NodeList net.332 2 33     ; Net list, zone 2, region 33
  2498.         
  2499.              5) NodeList hub.500 2:332 33 ; Hub list, zone 2, net 332,
  2500.                                           ; region 33
  2501.         
  2502.              6) NodeList locnode.500 2:332 33 500
  2503.                                           ; Some nodes, zone 2, net 332,
  2504.                                           ; region 33, hub 500
  2505.         
  2506.              7) NodeList points.504 2:332/504
  2507.                                           ; Points of 2:332/504 in
  2508.                                           ; "Point," format
  2509.         
  2510.              8) NodeList morenode.lst   ; Some nodes in the "Node,"
  2511.                                         ; format. No <PartAddr> required
  2512.                                         ; since the "Node," line gives
  2513.                                         ; full address info.
  2514.         
  2515.              9) NodeList ptlist.???     ; Point List in the "Boss,"
  2516.                                         ; format. No <PartAddr> required
  2517.                                         ; since the "Boss," line gives
  2518.                                         ; full address info.
  2519.         
  2520.         
  2521.                                  Input Section
  2522.         
  2523.         
  2524.         The following statements affect the handling of the nodelist
  2525.         specified by the last "NodeList" statement (current Input
  2526.         Block).
  2527.         
  2528.         
  2529.         
  2530.         NodeDiff <NodeDiff>
  2531.         
  2532.                 <NodeDiff> is the name of the nodediff file.
  2533.                 If you don't specify a path, <InputPath> is assumed.
  2534.         
  2535.                 <NodeDiff> must terminate with ".???". FastLst will
  2536.                 search for a suitable <NodeDiff>, considering the files
  2537.                 that have a 3 digit day of the year in the place of the
  2538.                 trailing '???'.
  2539.         
  2540.             Example:
  2541.         
  2542.                 NodeDiff NODEDIFF.???
  2543.         
  2544.         
  2545.         
  2546.         ArcList <ArcList> [<Keep#>]
  2547.         
  2548.                 You can specify the name of the archive containing
  2549.                 <NodeList>. It is necessary if you use automatic
  2550.                 extraction/rearchiving, but it can even be used only to
  2551.                 delete old files.
  2552.         
  2553.                 <ArcList> is used to extract new nodelists, to compress
  2554.                 them using the methods defined in "ArcMethod", to
  2555.                 compress the new nodelists after the application of
  2556.                 nodediffs.
  2557.         
  2558.                 If <ArcList> has a terminating ".???", all the files
  2559.                 that have a suitable fixed (.zip, .lzh etc.) or variable
  2560.                 (.z10, .z17, .l10, .l17 etc.) extension are considered,
  2561.                 taking the digits as the last 2 digits of the day of the
  2562.                 year.
  2563.         
  2564.                 If you really want to limit search to a specified fixed
  2565.                 or variable extension, you can do:
  2566.                 "ArcList nodelist.zip", to consider .zip only;
  2567.                 "ArcList nodelist.z??", to consider .z?? only.
  2568.         
  2569.                 <Keep#> optionally specifies the number of archives to
  2570.                 be kept, basing on the day of the year (the modification
  2571.                 file date is also used to infer the correct
  2572.                 chronological order).
  2573.         
  2574.                 If you maintain archives with multiple different
  2575.                 extensions (.z??, .l??, etc.) the actual number of files
  2576.                 increases, since multiple files with the same day
  2577.                 extension count for one.
  2578.         
  2579.                 The description associated to the deleted files is
  2580.                 removed from FILES.BBS.
  2581.         
  2582.             Example:
  2583.         
  2584.                 ArcList nodelist.??? 1
  2585.         
  2586.         
  2587.         
  2588.         ArcDiff <ArcDiff> [<Keep#>]
  2589.         
  2590.                 You can specify the name of the archive containing
  2591.                 <NodeDiff>. It is necessary if you use automatic
  2592.                 extraction/rearchiving, but it can even be used only to
  2593.                 delete old files.
  2594.         
  2595.                 <ArcDiff> must terminate with ".???".
  2596.         
  2597.                 All the files that have 2 digits in the place of the
  2598.                 last 2 '?' are examined, taking the digits as the last 2
  2599.                 digits of the day of the year.
  2600.         
  2601.                 If you really want to limit search to a specified
  2602.                 extension, you can do:
  2603.                 "ArcDiff nodediff.z??", to consider .z?? only.
  2604.         
  2605.                 <Keep#> optionally specifies the number of archives to
  2606.                 be kept, basing on the day of the year (the modification
  2607.                 file date is also used to infer the correct
  2608.                 chronological order). In the case of multiple archive
  2609.                 extensions, the actual number increases consequently.
  2610.         
  2611.                 The description associated to the deleted files is
  2612.                 removed from FILES.BBS.
  2613.         
  2614.             Example:
  2615.         
  2616.                 ArcDiff nodediff.??? 5
  2617.         
  2618.         
  2619.         
  2620.         ArcListDesc <Desc>
  2621.         ArcDiffDesc <Desc>
  2622.         
  2623.                 You can specify a description to be added to FILES.BBS
  2624.                 for the new nodelist and nodediff files created by
  2625.                 FastLst.
  2626.         
  2627.                 Some parameters are available:
  2628.         
  2629.                 %d : the 3 digit day number (0 padded)
  2630.                 %a : the archiver name
  2631.                 %D : the date, USA format (Feb 10, 1995)
  2632.                 %L : the date, Local format
  2633.         
  2634.             Example:
  2635.         
  2636.                 ArcListDesc Fido Nodelist for day %d (%D), %a format
  2637.                 ArcDiffDesc Fido Nodediff for day %d (%D), %a format
  2638.         
  2639.         
  2640.         
  2641.                                 Local Specifications
  2642.         
  2643.         
  2644.         You can use here the same statements described in the "Global
  2645.         Section B" and (if we are not in a "NoCompile" block) "Global
  2646.         Section C" and "Export Global Section" (see the Export Block
  2647.         below).
  2648.         
  2649.         
  2650.         
  2651.                              ADDRESS SPECIFIC STUFF
  2652.         
  2653.         
  2654.         You can specify here the address specific stuff that is related
  2655.         to the current source nodelist (if not inside a "NoCompile"
  2656.         block).
  2657.         
  2658.         If you have already used the "Output section" for specifying
  2659.         this kind of information, you can skip this section.
  2660.         
  2661.         WARNING:
  2662.         
  2663.         Often you will compile segments of a previously compiled
  2664.         nodelist. For example you could have a "NodeList nodelist.???"
  2665.         block for the world nodelist and then a "NodeList region.033"
  2666.         block for your region's nodelist segment.
  2667.         
  2668.         The majority of entries in the latter will be duplicates of
  2669.         entries already found in the former. However, in the case of
  2670.         duplicates, only the entries found in the last involved
  2671.         "NodeList" block will go to the indices and be active. This way
  2672.         you can compile the full world nodelist while keeping your
  2673.         segment up-to-date with local segments that get updated faster
  2674.         than the full nodelist.
  2675.         
  2676.         When you have to specify "Address Specific Stuff" for nodes that
  2677.         are present in more than one "NodeList", you must do that in the
  2678.         last involved "NodeList" block (or in the Output Section, of
  2679.         course), otherwise your indications will have no effect.
  2680.         
  2681.         For a list of allowed statements, please see the "Address
  2682.         Specific Stuff" section of the "Output" section above.
  2683.         
  2684.         
  2685.         
  2686.                                SEGMENT SELECTION
  2687.         
  2688.         
  2689.         You can use here the same statements described in "Segment
  2690.         Selection" in the Output Section (if not inside a "NoCompile"
  2691.         block).
  2692.         
  2693.         
  2694.         
  2695.                                  EXPORT Block
  2696.         
  2697.         
  2698.         FastLst can "export" segments of nodelist: e.g. you can export
  2699.         the Region 25 from the world nodelist to a file called
  2700.         Region25.???, where ??? stands for the day of the year. Note
  2701.         that this feature is for exporting segments of nodelist to a
  2702.         dedicated file. To compile segments you should continue using
  2703.         the "Segment Selection" section of FastLst.Cfg.
  2704.         
  2705.         These blocks MUST be at the _END_ of an "Input Block"; there can
  2706.         be multiple Export Blocks in a single Input Block.
  2707.         
  2708.         Obviously the Export Block is available for compiled nodelists
  2709.         only, thus it is illegal inside a "NoCompile" block.
  2710.         
  2711.         The export is done ONLY when a new NodeList is found (or when
  2712.         the file to be exported exists neither in uncompressed nor in
  2713.         archived form), even if the config file is changed. So, you can
  2714.         safely hatch the created arcfile via the AfterArcExport command
  2715.         with no danger of hatching it all the times you change something
  2716.         in the cfg. Under these conditions, if you really want to export
  2717.         anyway, you must use the -i command line switch.
  2718.         
  2719.         IMPORTANT: If you use the same export filename for multiple
  2720.         source nodelists, all the exported segments are appended one
  2721.         another. This way, if you like, you can make FastLst generate a
  2722.         "plain" nodelist file with many different source nodelists in
  2723.         it, just appended one after another. Some people need this
  2724.         feature to create input for some other program. For this feature
  2725.         to work, you need to specify the '+' parameter in the "Export"
  2726.         statement. See "Export Example" below.
  2727.         
  2728.         
  2729.         
  2730.         Export [+] <file> [<PartAddrLst>]
  2731.         
  2732.                 The '+' sign must be specified when you want to create a
  2733.                 joined list by exporting multiple nodelists to the same
  2734.                 export <file>. This way the exported file will be
  2735.                 created every time the nodelist is compiled and its
  2736.                 timestamp will not be changed to be equal to the source.
  2737.         
  2738.                 <file> is the name of the file to which you want to
  2739.                 export the selected segment(s).
  2740.         
  2741.                 <PartAddrLst> is the partial address list of segments to
  2742.                 be exported. Usually it is a single partial address.
  2743.                 If omitted, the entire nodelist is exported (useful to
  2744.                 create a joined nodelist).
  2745.         
  2746.                 This statement marks the start of an "Export Block".
  2747.                 Multiple "Export Blocks" are allowed in the same "Input
  2748.                 Block".
  2749.         
  2750.                 N.B. The Export blocks must be at the _END_ of an input
  2751.                 block. See "Export Example" below.
  2752.         
  2753.             Example:
  2754.         
  2755.                 Export region25.??? 2:25
  2756.         
  2757.         
  2758.         
  2759.         
  2760.                                  Export Section
  2761.         
  2762.         
  2763.         The following verbs define the parameters for the Export
  2764.         specified by the last "Export" statement.
  2765.         
  2766.         
  2767.         
  2768.         ArcExport <arcfile> [Keep#]
  2769.         
  2770.                 <arcfile> is the name of the archive file to which you
  2771.                 want to compress the exported <file>.
  2772.         
  2773.                 [Keep#] is the optional number of archive versions to be
  2774.                 kept, basing on the day of the year (the modification
  2775.                 file date is also used to infer the correct
  2776.                 chronological order).
  2777.         
  2778.             Example:
  2779.         
  2780.                 ArcExport region25.??? 2
  2781.         
  2782.         
  2783.         
  2784.         ArcExportDesc <description>
  2785.         
  2786.                 <description> is the description to be applied to
  2787.                 FILES.BBS when a new archive is created.
  2788.         
  2789.             Example:
  2790.         
  2791.                 ArcExportDesc Region 25 %D, %a format
  2792.         
  2793.         
  2794.         
  2795.         
  2796.                              Export Global Section
  2797.         
  2798.         
  2799.         The following verbs can be used in the "Export Section" of an
  2800.         "Export Block", in the "Input Section" of an "Input Block", in
  2801.         the "Output Section" of an "Output Block", in the "Global
  2802.         Section".
  2803.         
  2804.         In few words, they are legal everywhere except for the
  2805.         "NoCompile" block.
  2806.         
  2807.         Depending on their positions, they affect the involved nodelists
  2808.         only.
  2809.         
  2810.         
  2811.         
  2812.         ArcExportMethod <meth>[,<f>] ...
  2813.         
  2814.                 Specifies the archive type(s) to be created for the
  2815.                 exported file.
  2816.         
  2817.                 <meth> is the archiver name as defined in Compress.Cfg.
  2818.         
  2819.                 <f> is the optional first letter to be used for variable
  2820.                 archive extensions.
  2821.         
  2822.             Example:
  2823.         
  2824.                 ArcExportMethod zip lh,H
  2825.         
  2826.         
  2827.         
  2828.         BeforeArcExport <command>
  2829.         AfterArcExport <command>
  2830.         
  2831.                 Commands to be run before/after archiving the exported
  2832.                 file.
  2833.         
  2834.                 <command> can be any type of command (executable file,
  2835.                 batch file, internal command, alias, etc.) and supports
  2836.                 the %a (full archive name) and %f (name of the file to
  2837.                 be compressed, no path) and is run from the directory
  2838.                 where %f resides.
  2839.         
  2840.                 WARNING: since <command> is executed from the directory
  2841.                 where the file to be compressed belongs, you might need
  2842.                 to specify the location of the config files used by the
  2843.                 programs invoked via <command>.
  2844.         
  2845.             Example:
  2846.         
  2847.                 AfterArcExport Hatch %a
  2848.         
  2849.         
  2850.         
  2851.         ExportNeededBeforeKill
  2852.         
  2853.                 Specifies that the exported file is needed by the
  2854.                 "BeforeKillSource" command.
  2855.         
  2856.         
  2857.             Export Example:
  2858.         
  2859.                 NodeList nodelist.???
  2860.                   NodeDiff nodediff.???
  2861.                   ArcList  nodelist.??? 2
  2862.                   ArcDiff  nodediff.??? 5
  2863.                   ArcListDesc Fido Nodelist for day %d (%D), %a format
  2864.                   ArcDiffDesc Fido Nodediff for day %d,(%D), %a format
  2865.                   Export region25.??? 2:25
  2866.                     ArcExport region25.??? 1
  2867.                     ArcExportDesc Region 25 %D, %a format
  2868.                     ArcExportMethod zip lh
  2869.                     AfterArcExport Hatch %a
  2870.                   Export region24.??? 2:24
  2871.                     ArcExport region24.??? 1
  2872.                     ArcExportDesc Region 24 %D, %a format
  2873.                     ArcExportMethod zip
  2874.         
  2875.         
  2876.             Export Example to generate a joined list:
  2877.         
  2878.                 NodeList nodelist.???
  2879.                   NodeDiff nodediff.???
  2880.                   ArcList  nodelist.??? 2
  2881.                   ArcDiff  nodediff.??? 5
  2882.                   ArcListDesc Fido Nodelist for day %d (%D), %a format
  2883.                   ArcDiffDesc Fido Nodediff for day %d,(%D), %a format
  2884.                   Export + megalist.Lst
  2885.         
  2886.                 NodeList zonelist.???
  2887.                   NodeDiff zonediff.???
  2888.                   ArcList  zonelist.??? 2
  2889.                   ArcDiff  zonediff.??? 5
  2890.                   ArcListDesc Zonelist for day %d (%D), %a format
  2891.                   ArcDiffDesc Zonediff for day %d,(%D), %a format
  2892.                   Export + megalist.Lst
  2893.                     ArcExport megalist.??? 1
  2894.                     ArcExportDesc MegaList, %a format
  2895.                     ArcExportMethod zip lh
  2896.         
  2897.         
  2898.  
  2899.         
  2900.                             COMPRESS DEFINITION FILE
  2901.         
  2902.         
  2903.         The file specified in the CompressCfg statement is a sequence of
  2904.         Archive definition blocks, each one starting with "Archiver" and
  2905.         ending with "End Archiver". You can find an example in the
  2906.         Compress.Cfg file included in the distribution pack.
  2907.         
  2908.         The order of the archive definition blocks within this file may
  2909.         be important: when trying to unpack a compressed file, the list
  2910.         of archivers is scanned in a reverse order.
  2911.         
  2912.         In the case of two archivers that use the same identification
  2913.         string (e.g. ARC and PAK), you must specify the archiver that
  2914.         can unpack both (PAK) after the other one (ARC).
  2915.         
  2916.         The compress.cfg file can be shared between DOS/NT and OS/2
  2917.         applications: the "DOS" and "OS2" keywords are available to
  2918.         distinguish between the commands to be used under DOS/NT and
  2919.         OS/2.
  2920.         
  2921.         O.S. specific archivers or commands must be prefixed with the
  2922.         relevant keyword.
  2923.         
  2924.         IMPORTANT NOTE: The lines that begin with "DOS" or "OS2" are
  2925.         parsed by the DOS/NT and OS/2 versions respectively. If you need
  2926.         the OS/2 version to execute a DOS command, you MUST NOT use the
  2927.         DOS keyword: if you do, it will never parse that line; if you do
  2928.         not, it will execute the DOS command "normally", provided you
  2929.         have installed OS/2's Dos support.
  2930.         
  2931.         See the examples below.
  2932.         
  2933.         
  2934.         Archiver <ARCname>
  2935.         
  2936.                 Starts the Archive definition block.
  2937.         
  2938.                 <ARCname> is the name used to identify this archiver.
  2939.         
  2940.             Example:
  2941.         
  2942.                 Archiver ZIP
  2943.         
  2944.         
  2945.         
  2946.         Extension  <ext>
  2947.         
  2948.                 Specifies the default extension for the compressed
  2949.                 files.
  2950.         
  2951.             Example:
  2952.         
  2953.                 Extension ZIP
  2954.         
  2955.         
  2956.         
  2957.         Ident <ofs>,<ID>
  2958.         
  2959.                 <ofs> is a decimal integer number representing the
  2960.                 offset at which an archive identity marker <ID> must be
  2961.                 present.
  2962.         
  2963.                 Negative values can be used to indicate offsets from the
  2964.                 END of a compressed file. -1 means "the last byte", -2
  2965.                 "the second last byte" and so on.
  2966.         
  2967.                 <ID> is a series of hexadecimal figures which represent
  2968.                 the bytes of the marker string that must be present at
  2969.                 the specified offset of the archive file.
  2970.         
  2971.             Example:
  2972.         
  2973.                 Ident 0,504b0304  ; "PK^c^d"
  2974.         
  2975.         
  2976.         
  2977.         Add <command>
  2978.         
  2979.                 Specifies the command to add files to an archive.
  2980.                 %a and %f are translated to the name of the archive and
  2981.                 file to add.
  2982.         
  2983.             Example:
  2984.         
  2985.                 Add zip -jk %a %f
  2986.         
  2987.         
  2988.         
  2989.         Extract <command>
  2990.         
  2991.                 Specifies the command to extract files from an archive.
  2992.                 %a and %f are translated to the name of the archive and
  2993.                 file to extract.
  2994.         
  2995.             Example:
  2996.         
  2997.                 Extract unzip -qqnjC %a %f
  2998.         
  2999.         
  3000.         
  3001.         View <command>
  3002.         
  3003.                 This line is recognized and accepted for compatibility,
  3004.                 but not used.
  3005.         
  3006.         
  3007.         
  3008.         End Archiver
  3009.         
  3010.                 This statement is used to close a Archive definition.
  3011.         
  3012.         
  3013.                                     Examples
  3014.         
  3015.         
  3016.             Complete example 1 (you need OS/2 only):
  3017.         
  3018.         Archiver ZIP
  3019.              Extension     ZIP
  3020.              Ident         0,504b0304
  3021.              Add           zip -jk %a %f
  3022.              Extract       unzip -qqnjC %a %f
  3023.              View          unzip -v %a
  3024.         End Archiver
  3025.         
  3026.         
  3027.             Complete example 2 (you need DOS only):
  3028.         
  3029.         Archiver ZIP
  3030.              Extension     ZIP
  3031.              Ident         0,504b0304
  3032.              Add           pkzip -a %a %f
  3033.              Extract       pkunzip -n %a %f
  3034.              View          pkzip -v %a
  3035.         End Archiver
  3036.         
  3037.         
  3038.             Complete example 3 (you need both OS/2 and DOS):
  3039.         
  3040.         Archiver ZIP
  3041.              Extension     ZIP
  3042.              Ident         0,504b0304
  3043.         OS2  Add           zip -jk %a %f
  3044.         DOS  Add           pkzip -a %a %f
  3045.         OS2  Extract       unzip -qqnjC %a %f
  3046.         DOS  Extract       pkunzip -n %a %f
  3047.         OS2  View          unzip -v %a
  3048.         DOS  View          pkzip -v %a
  3049.         End Archiver
  3050.         
  3051.         
  3052.             Complete example 4 (archiver to be used under DOS only):
  3053.         
  3054.         DOS Archiver ZOO
  3055.         DOS     Extension       ZOO
  3056.         DOS     Ident           0,5a4f4f                        ; "ZOO"
  3057.         DOS     Add             zoo a: %a %f
  3058.         DOS     Extract         zoo e:O %a %f
  3059.         DOS     View            zoo v %a
  3060.         DOS End Archiver
  3061.         
  3062.         
  3063.             Complete example 5 (it's a DOS executable, to be used under
  3064.                                 DOS or OS/2 indifferently):
  3065.         
  3066.         Archiver ZOO
  3067.              Extension       ZOO
  3068.              Ident           0,5a4f4f                        ; "ZOO"
  3069.              Add             zoo a: %a %f
  3070.              Extract         zoo e:O %a %f
  3071.              View            zoo v %a
  3072.         End Archiver
  3073.  
  3074.         
  3075.         
  3076.                          T R O U B L E S H O O T I N G
  3077.         
  3078.         
  3079.                                Extraction problem
  3080.         
  3081.         Problem:
  3082.                   FastLst does not extract the correct
  3083.                   nodelist/nodediff.
  3084.         
  3085.         Solution:
  3086.                   Perhaps there is some nodelist/nodediff with corrupted
  3087.                   file date. Check your "ArcPath", manually extract to
  3088.                   the "InputPath" the required nodelist/nodediff and
  3089.                   delete the archive (or reset its file-date so that it
  3090.                   is similar to that of the enclosed file). FastLst will
  3091.                   automatically rearchive the nodelist/nodediff if you
  3092.                   use "ArcMethod"/"ArcDiffMethod", otherwise you can
  3093.                   rearchive manually.
  3094.         
  3095.         
  3096.                                  Out of Memory
  3097.         
  3098.         Problem:
  3099.                   FastLst runs out of memory (Dos versions).
  3100.         
  3101.         Solution:
  3102.                   - give more DPMI memory to FastLst
  3103.         
  3104.                   - enable the DOS4GW virtual memory mode, using the
  3105.                     DOS4GVM environment variable (e.g. for 16MB virtual
  3106.                     allocation size: SET DOS4GVM=VirtualSize#16384).
  3107.         
  3108.                     This works under real Dos only: if you are using
  3109.                     OS/2 dos sessions, use a higher DPMI_MEMORY_LIMIT in
  3110.                     the Dos settings.
  3111.         
  3112.         
  3113.                        Problems with Empty Phone entries
  3114.         
  3115.         Problem:
  3116.                   Some program behaves oddly while accessing entries
  3117.                   that contain an empty phone number.
  3118.         
  3119.         Solution:
  3120.                   The problem might be caused by the cost that is
  3121.                   assigned to empty-phone nodes (65535 by default).
  3122.                   Try using the "CostNullPhone" global statement to give
  3123.                   lower costs.
  3124.         
  3125.                   Example:
  3126.         
  3127.                   CostNullPhone 900 0
  3128.         
  3129.         
  3130.                                 Slow processing
  3131.         
  3132.         Problem:
  3133.                   FastLst works very slowly.
  3134.         
  3135.         Solution:
  3136.                   Perhaps you are compiling a large nodelist or set of
  3137.                   nodelists on a system with few MegaBytes of free
  3138.                   physical RAM, so that the OS needs to extensively use
  3139.                   virtual memory. Try using the "LinkOnDisk" statement
  3140.                   in the configuration file.
  3141.         
  3142.         
  3143.                          System performance degradation
  3144.         
  3145.         Problem:
  3146.                   FastLst loads the system excessively, so that other
  3147.                   OS/2 tasks don't perform properly (OS/2 version).
  3148.         
  3149.         Solution:
  3150.                   Use the "Priority Idle" statement in the configuration
  3151.                   file, so that FastLst receives its time slices only
  3152.                   when other processes with higher priority are idle.
  3153.         
  3154.         
  3155.                               I want maximum speed
  3156.         
  3157.         Problem:
  3158.                   I run FastLst while the communications are off, so I
  3159.                   would like it to run as fast as possible even if it is
  3160.                   in the background and other tasks are active (OS/2
  3161.                   version).
  3162.         
  3163.         Solution:
  3164.                   Use the "Priority High 31" statement in the
  3165.                   configuration file, so that FastLst receives the
  3166.                   maximum priority for "non time-critical" processes.
  3167.         
  3168.         
  3169.                          Archived Diffs are not applied
  3170.         
  3171.         Problem:
  3172.                   FastLst does not apply the archived Diffs.
  3173.         
  3174.         Solution:
  3175.                   Remember that "InputPath <path>" is the default path
  3176.                   for lists and diffs, while "ArcPath <path>" is the one
  3177.                   for archives.
  3178.         
  3179.                   Please compare your Compress.cfg with the example one,
  3180.                   check the paths and try the commands manually.
  3181.         
  3182.                   Check the day-extensions and time-stamps of the
  3183.                   relevant files.
  3184.                  
  3185.         
  3186.                             Dos/32 DOS4GW exception
  3187.         
  3188.         Problem:
  3189.                   The Dos/32 version of FastLst aborts with an exception
  3190.                   from the Dos extender.
  3191.         
  3192.         Solution:
  3193.                   Try booting with a "clean" config.sys and autoexec.bat
  3194.                   (the Dos extender might be incompatible with some of
  3195.                   your loaded drivers or TSRs.
  3196.         
  3197.         
  3198.                        Dial Scripts and VMODEM addresses
  3199.         
  3200.         Problem:
  3201.                   How can I put script names or internet addresses in
  3202.                   the place of a phone number ?
  3203.         
  3204.         Solution:
  3205.                   You may use the "Phone" statement.
  3206.         
  3207.                   Example:
  3208.         
  3209.                   Let's suppose the following Modem Type table is
  3210.                   defined:
  3211.         
  3212.                   TypeDef
  3213.                     X75    1
  3214.                     V34    2
  3215.                     VM     3
  3216.                   End
  3217.         
  3218.                   You may use a Phone override of this kind:
  3219.         
  3220.                   Phone 2:345/678 domain.com VM,CM 10 0
  3221.         
  3222.                   And a ModemTrans (for Binkley's VMODEM line):
  3223.         
  3224.                   ModemTrans   0
  3225.                   ModemTrans   1
  3226.                   ModemTrans   2
  3227.                   ModemTrans   3 ATDT#  ; Vmodem
  3228.         
  3229.         
  3230.         
  3231.                           Region and zone-level Export
  3232.         
  3233.         Problem:
  3234.                   How can I export a Region segment together with the
  3235.                   zone-level entries ?
  3236.         
  3237.         Solution:
  3238.                   The zone level entries have the Region/Net field equal
  3239.                   to the zone number; you can use the Export statement
  3240.                   in the following way:
  3241.         
  3242.                   export MyR33.??? 1:1 2:2 2:33 3:3 4:4 5:5 6:6
  3243.         
  3244.         
  3245.                                    Support ?
  3246.         
  3247.         Problem:
  3248.                   I cannot find the solution to my problems.
  3249.         
  3250.         Solution:
  3251.                   - Try linking the APWORKS support echo
  3252.                   - Try asking your local supporter
  3253.                   - Try asking the author directly
  3254.                   You can find the addresses in the ReadMe.1st file.
  3255.         
  3256.  
  3257.         
  3258.                                S H A R E W A R E
  3259.         
  3260.         
  3261.         If you like this program and continue using it, you should pay
  3262.         the author for his work, as per the ShareWare concept of
  3263.         distribution.
  3264.         
  3265.         Please see LICENSE.DOC and REGISTER.DOC for information.
  3266.         
  3267.         Thank you for your interest in FastLst.
  3268.         
  3269.